Install with pip
You need to use
pip to install dbt Core on Windows or Linux operating systems. You can use
pip or Homebrew for installing dbt Core on a MacOS.
You can install dbt Core and plugins using
pip because they are Python modules distributed on PyPI. We recommend using virtual environments when installing with
Once you know which adapter you're using, you can install it as
dbt-<adapter>. For example, if using Postgres:
pip install dbt-postgres
This will install
$ dbt --version
installed version: 1.0.0
latest version: 1.0.0
Up to date!
- postgres: 1.0.0
All adapters build on top of
dbt-core. Some also depend on other adapters: for example,
dbt-redshift builds on top of
dbt-postgres. In that case, you would see those adapters included by your specific installation, too.
To upgrade a specific adapter plugin:
pip install --upgrade dbt-<adapter>
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.
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:
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:
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 and will raise an explicit error. Since v0.13, the PyPI package named
dbt was a simple "pass-through" of
dbt-core and the four original database adapter plugins. For v1, we formalized that split.
If you have workflows or integrations that relied on installing the package named
dbt, you can achieve the same behavior going forward by installing the same five packages that it used:
pip install \
Or, better yet, just install the package(s) you need!