Skip to main content

Install dbt Cloud CLI

dbt Cloud natively supports developing using a command line (CLI), empowering team members to contribute with enhanced flexibility and collaboration. The dbt Cloud CLI allows you to run dbt commands against your dbt Cloud development environment from your local command line.

dbt commands are run against dbt Cloud's infrastructure and benefit from:

  • Secure credential storage in the dbt Cloud platform.
  • Automatic deferral of build artifacts to your Cloud project's production environment.
  • Speedier, lower-cost builds.
  • Support for dbt Mesh (cross-project ref),
  • Significant platform improvements, to be released over the coming months.


The dbt Cloud CLI is available in all deployment regions and for both multi-tenant and single-tenant accounts (Azure single-tenant not supported at this time).

Install dbt Cloud CLI

You can install the dbt Cloud CLI on the command line by using one of these methods.

View a video tutorial for a step-by-step guide to installation.

Before you begin, make sure you have Homebrew installed in your code editor or command line terminal. Refer to the FAQs if your operating system runs into path conflicts.

  1. Verify that you don't already have dbt Core installed:

    which dbt
    • If you see a dbt not found, you're good to go. If the dbt help text appears, use pip uninstall dbt to remove dbt Core from your system.
  2. Install the dbt Cloud CLI with Homebrew:

    • First, remove the dbt-labs tap, the separate repository for packages, from Homebrew. This prevents Homebrew from installing packages from that repository:
      brew untap dbt-labs/dbt
    • Then, add and install the dbt Cloud CLI as a package:
      brew tap dbt-labs/dbt-cli
      brew install dbt
      If you have multiple taps, use brew install dbt-labs/dbt-cli/dbt.
  3. Verify your installation by running dbt --help in the command line. If you see the following output, your installation is correct:

    The dbt Cloud CLI - an ELT tool for running SQL transformations and data models in dbt Cloud...

    If you don't see this output, check that you've deactivated pyenv or venv and don't have a global dbt version installed.

    • Note that you no longer need to run the dbt deps command when your environment starts. This step was previously required during initialization. However, you should still run dbt deps if you make any changes to your packages.yml file.
  4. Clone your repository to your local computer using git clone. For example, to clone a GitHub repo using HTTPS format, run git clone

  5. After cloning your repo, configure the dbt Cloud CLI for your dbt Cloud project. This lets you run dbt commands like dbt environment show to view your dbt Cloud configuration or dbt compile to compile your project and validate models and tests. You can also add, edit, and synchronize files with your repo.

Update dbt Cloud CLI

The following instructions explain how to update the dbt Cloud CLI to the latest version depending on your operating system.

During the public preview period, we recommend updating before filing a bug report. This is because the API is subject to breaking changes.

To update the dbt Cloud CLI, run brew update and then brew upgrade dbt.

Using VS Code extensions

Visual Studio (VS) Code extensions enhance command line tools by adding extra functionalities. The dbt Cloud CLI is fully compatible with dbt Core, however, it doesn't support some dbt Core APIs required by certain tools, for example, VS Code extensions.

You can use extensions like dbt-power-user with the dbt Cloud CLI by following these steps:

This setup allows dbt-power-user to continue to work with dbt Core in the background, alongside the dbt Cloud CLI. For more, check the dbt Power User documentation.


 What's the difference between the dbt Cloud CLI and dbt Core?
 How do I run both the dbt Cloud CLI and dbt Core?
 How to create an alias?
 Why am I receiving a `Session occupied` error?