Skip to main content

Install with Homebrew

caution

Starting with v1.6, dbt Labs will no longer maintain Homebrew formulae as a supported installation method for dbt-core and adapters. For more on our rationale, consult this discussion:

dbt Labs maintains Homebrew formulae for the four oldest and most popular adapter plugins: Postgres, Redshift, Snowflake, and BigQuery.

We recommend you use Homebrew if you meet these conditions:

  • You use MacOS for local development
  • You use dbt with one of the four databases listed above
  • You're not sure if you have system requirements (such as Python 3) already installed, and don't care to manage them by hand

If that sounds like you, great! Homebrew makes it significantly easier to install dbt Core. Note that:

  • Installation with Homebrew can take longer than installing with other methods, because brew takes care of more setup behind the scenes
  • If you're using an M1 Mac, we recommend that you install dbt via Homebrew with Rosetta. This is necessary for certain dependencies that are only supported on Intel processors.

If you're someone who prefers to manage Python environments yourself, such as having multiple versions of Python to switch between, we recommend you install dbt Core via pip instead.

Installing with Homebrew

Install Homebrew. Then run this one-time setup:

brew update
brew install git
brew tap dbt-labs/dbt

Now you're ready to install dbt. Once you know which adapter you're using, you can install it as dbt-ADAPTER_NAME. For instance, if using Postgres:

brew install dbt-postgres

Everywhere below that you see ADAPTER_NAME, replace it with the adapter name you're using.

Note: If you're using an adapter that isn't available as a Homebrew formula, we recommend you use pip instead.

Upgrading dbt and your adapter

To upgrade dbt, use:

brew update
brew upgrade dbt-ADAPTER_NAME

Switching versions

You can install and use multiple versions of dbt with Homebrew through something called Homebrew "links." To allow installation of another version of dbt, first unlink the current version:

brew unlink dbt-ADAPTER_NAME
brew install dbt-ADAPTER_NAME@1.0.0
brew link dbt-ADAPTER_NAME@1.0.0

Now, you can use dbt Core v1.0.0:

$ dbt --version
installed version: 1.0.0
latest version: 1.0.0

Up to date!

Plugins:
- ADAPTER_NAME: 1.0.0

You can switch between versions by linking the one you want to use:

brew unlink dbt-ADAPTER_NAME@1.0.0
brew link dbt-ADAPTER_NAME@0.21.1
0