Video | Tableau | Data engineering | Data prep

How to set up a Postgres database on your Mac

Installing Postgres on a Mac is mostly the same as Windows — bar a few Catalina quirks I'll show you how to dodge.

Watch on YouTube
  • Download the PostgreSQL installer from EnterpriseDB and keep the default install and data directories unless you know what you're doing
  • If a previous install left a Postgres data folder behind, move or delete the leftover folder in the Library before re-running the installer
  • On Catalina, let Stack Builder download the PostGIS plugin but skip its install, then run the unzipped installer manually so it prompts correctly for credentials
  • Postgres doesn't show as a normal app — launch it via PG_ADMIN4 in the Applications/Postgres folder and watch for the elephant icon to confirm the server is running
  • Connect Tableau Prep to localhost with database and username 'postgresql' to write a table, using Replace Data to avoid appending duplicate rows on re-runs

I walk through installing PostgreSQL on a Mac and connecting it to Tableau Prep, flagging the specific quirks Catalina throws up around leftover data folders and the PostGIS plugin that don't come up on Windows.

This mirrors my Windows Postgres install video but covers the Mac-specific snags. I'm installing PostgreSQL 12.4 from EnterpriseDB and then writing a table to it from Tableau Prep 2020.3 to prove it's working.

The Breakdown
  1. Download and run the installer 0:21

    Get the Mac installer from the EnterpriseDB download page and run it. Leave the install and data directory paths as default unless you specifically know you need to change them.

  2. Clear out a leftover data directory first 0:58

    If you've had Postgres installed before, the setup may fail to overwrite the existing data folder. Before rerunning the installer, go into the Library folder, find the PostgreSQL version folder and move or delete it so the fresh install has a clean target.

  3. Let Stack Builder fetch PostGIS, but don't let it install 4:40

    Stack Builder runs after the main install to add plugins like PostGIS for spatial functions. On Catalina, tick the box to download the plugin but skip letting Stack Builder actually install it — letting it finish here causes errors.

  4. Finish the PostGIS install manually 6:06

    Unzip the file Stack Builder downloaded and double-click the installer inside it yourself. Run this way, it correctly prompts you for your database username and password, whereas running it through Stack Builder does not.

  5. Launch Postgres via pgAdmin, not Spotlight 7:13

    Postgres won't show up as a normal app in Spotlight or Alfred. Go to the Applications/Postgres folder and open PG_ADMIN4 — you can drag it to your dock for easier access afterwards. An elephant icon appearing confirms the server is actually running.

  6. Write a table from Tableau Prep to confirm it works 9:11

    In Prep's output step, switch from writing a file to writing to a database table, choose PostgreSQL, and connect using localhost as the server with 'postgresql' as both the database name and username. Use Replace Data rather than the default append option so rerunning the flow doesn't keep stacking duplicate rows.

  7. Uninstalling cleanly 11:40

    Don't just delete files from the Applications/Postgres folder. Instead go to Library/Postgres/[version] and run the uninstaller there, which lets you remove everything or pick individual components and properly clears old databases, passwords and config.

Worth Knowing
  • Writing to the database from Tableau Prep in this way needs Tableau Prep 2020.3 or later — older versions won't have this database output option.
  • Catalina specifically breaks the PostGIS install if you let Stack Builder run it directly; downloading via Stack Builder but installing manually avoids the error.
  • A leftover Postgres data folder from a prior install is a common cause of the installer failing to progress — it's not obvious from the error message alone.
Use It When

Reach for this when you need a local Postgres instance on a Mac for testing or development, particularly if you're feeding it from Tableau Prep and want a working spatial (PostGIS) setup without Catalina's install quirks tripping you up.

How this Rollup was made provenance & method

A Rollup is drafted by AI from the video's transcript, then reviewed and edited by Tim. Everything used to produce this one is listed below — the model, the exact prompt, and the source video — so the process is transparent and reproducible.

Transcription
On-device — NVIDIA Parakeet v3 for recent videos, OpenAI Whisper large-v3 for earlier ones. The transcript never leaves the machine or gets published.
Drafting
Claude Sonnet 5 in the cloud, from that transcript.
Prompt
The exact Rollup prompt (v2) — the full system prompt, unedited.
Source video
Watch on YouTube
Drafted
5 July 2026 at 09:38
Reviewed & edited
5 July 2026 at 09:41 · by Tim Ngwena

Model + prompt + video is everything you'd need to recreate a Rollup like this yourself. The one thing we don't share is the transcript.

Rights. The video and its transcript are the property of TN Media Ltd. Unauthorised use or download is prohibited. © TN Media Ltd.