Install with pip

You need to use pip to install dbt Core on Windows, Linux, or MacOS operating systems.

You can install dbt Core and plugins using pip because they are Python modules distributed on PyPI.

Does my operating system have prerequisites?

Your operating system may require pre-installation setup before installing dbt Core with pip. After downloading and installing any dependencies specific to your development environment, you can proceed with the pip installation of dbt Core.

CentOS

CentOS requires Python and some other dependencies to successfully install and run dbt Core.

To install Python and other dependencies:

sudo yum install redhat-rpm-config gcc libffi-devel \
  python-devel openssl-devel

MacOS

The MacOS requires Python 3.8 or higher to successfully install and run dbt Core.

To check the Python version:

python --version

If you need a compatible version, you can download and install Python version 3.9 or higher for MacOS.

If your machine runs on an Apple M1 architecture, we recommend that you install dbt via Rosetta. This is necessary for certain dependencies that are only supported on Intel processors.

Ubuntu/Debian

Ubuntu requires Python and other dependencies to successfully install and run dbt Core.

To install Python and other dependencies:

sudo apt-get install git libpq-dev python-dev python3-pip
sudo apt-get remove python-cffi
sudo pip install --upgrade cffi
pip install cryptography~=3.4

Windows

Windows requires Python and git to successfully install and run dbt Core.

Install Git for Windows and Python version 3.9 or higher for Windows.

For further questions, please see the Python compatibility FAQ

What version of Python can I use?

Use this table to match dbt-core versions with their compatible Python versions. New dbt minor versions will add support for new Python3 minor versions when all dependencies can support it. In addition, dbt minor versions will withdraw support for old Python3 minor versions before their end of life.

Python compatibility matrix

dbt-core version	v1.8	v1.7	v1.6	v1.5	v1.4	v1.3	v1.2	v1.1	v1.0
Python 3.12	✅	✅	❌	❌	❌	❌	❌	❌	❌
Python 3.11	✅	✅	✅	✅	✅	❌	❌	❌	❌
Python 3.10	✅	✅	✅	✅	✅	✅	✅	✅	✅
Python 3.9	✅	✅	✅	✅	✅	✅	✅	✅	✅

Adapter plugins and their dependencies are not always compatible with the latest version of Python. For example, dbt-snowflake v0.19 is not compatible with Python 3.9, but dbt-snowflake versions 0.20+ are.

Using virtual environments

We recommend using virtual environments (venv) to namespace pip modules.

1. Create a new venv:

python -m venv dbt-env				# create the environment

2. Activate that same virtual environment each time you create a shell window or session:

source dbt-env/bin/activate			# activate the environment for Mac and Linux OR
dbt-env\Scripts\activate			# activate the environment for Windows

Create an alias

To activate your dbt environment with every new shell window or session, you can create an alias for the source command in your $HOME/.bashrc, $HOME/.zshrc, or whichever config file your shell draws from.

For example, add the following to your rc file, replacing <PATH_TO_VIRTUAL_ENV_CONFIG> with the path to your virtual environment configuration.

alias env_dbt='source <PATH_TO_VIRTUAL_ENV_CONFIG>/bin/activate'

Installing the adapter

Once you decide which adapter you're using, you can install using the command line. Beginning in v1.8, installing an adapter does not automatically install dbt-core. This is because adapters and dbt Core versions have been decoupled from each other so we no longer want to overwrite existing dbt-core installations.

For example, if using Postgres:

Upgrade adapters

To upgrade a specific adapter plugin:

python -m pip install --upgrade dbt-ADAPTER_NAME

Install dbt-core only

If you're building a tool that integrates with dbt Core, you may want to install the core library alone, without a database adapter. Note that you won't be able to use dbt as a CLI tool.

python -m pip install dbt-core

Change dbt Core versions

You can upgrade or downgrade versions of dbt Core by using the --upgrade option on the command line (CLI). For more information, see Best practices for upgrading in Core versions.

To upgrade dbt to the latest version:

python -m pip install --upgrade dbt-core

To downgrade to an older version, specify the version you want to use. This command can be useful when you're resolving package dependencies. As an example:

python -m pip install --upgrade dbt-core==0.19.0

pip install dbt

Note that, as of v1.0.0, pip install dbt is no longer supported, will raise an explicit error, and the dbt package on PyPI stopped receiving updates. Since v0.13, PyPI package named dbt was a simple "pass-through" of dbt-core and the four original database adapter plugins.

In the fall of 2023, the dbt package on PyPI became a supported method to install the dbt Cloud CLI.

If you have workflows or integrations that rely on installing the package named dbt, you can achieve the same behavior by installing the same five packages that it used:

python -m pip install \
  dbt-core \
  dbt-postgres \
  dbt-redshift \
  dbt-snowflake \
  dbt-bigquery \
  dbt-trino

Or, better yet, just install the package(s) you need!

Install prereleases of dbt adapters

To install prerelease versions of dbt Core and your adapter, use this command:

python3 -m pip install --pre dbt-core dbt-adapter-name

We recommend you install prereleases in a virtual Python environment. You can run the commands to activate and install your virtual environment. You’ll need to activate your virtual environment before you start installing or using packages within it. For example, to install a prerelease in a POSIX bash/zsh virtual Python environment, use the following command:

dbt --version
python3 -m venv venv
source venv/bin/activate
python3 -m pip install --upgrade pip
python3 -m pip install --pre dbt-core dbt-adaptername
source venv/bin/activate
dbt --version

Install prereleases on different operating systems

To install or use packages within your virtual environment:

• Activate the virtual environment to add its specific Python and pip executables to your shell’s PATH. This ensures you use the environment’s isolated setup. You can run the following commands to activate your virtual environment.

• Select your operating system to activate your virtual environment.

 Unix/macOS

source .venv/bin/activate
which python
.venv/bin/python

These commands will install the prerelease:

python3 -m pip install --upgrade pip
python3 -m pip --version
pip 23.3.1 from .../.venv/lib/python3.9/site-packages (python 3.9)

 Windows

.venv\Scripts\activate
where python
.venv\Scripts\python

These commands will install the prerelease:

py -m pip install --upgrade pip
py -m pip --version
pip 23.3.1 from .venv\lib\site-packages (Python 3.9.4)

If you’re using a different operating system, refer to Git issue on Instructions to create a python virtual environment for more information.