Skip to main content

Run your dbt projects

You can run your dbt projects with dbt Cloud and dbt Core. dbt Cloud is a hosted application where you can develop directly from a web browser. dbt Core is an open source project where you can develop from the command line.

Among other features, dbt Cloud provides a development environment to help you build, test, run, and version control your project faster. It also includes an easier way to share your dbt project's documentation with your team. These development tasks are directly built into dbt Cloud for an integrated development environment (IDE). Refer to Develop in the Cloud for more details.

With dbt Core, you can run your dbt projects from the command line. The command line interface (CLI) is available from your computer's terminal application such as Terminal and iTerm. When using the command line, you can run commands and do other work from the current working directory on your computer. Before running the dbt project from the command line, make sure you are working in your dbt project directory. Learning terminal commands such as cd (change directory), ls (list directory contents), and pwd (present working directory) can help you navigate the directory structure on your system.

When running your project from dbt Core or dbt Cloud, the commands you commonly use are:

  • dbt run Runs the models you defined in your project
  • dbt build Builds and tests your selected resources such as models, seeds, snapshots, and tests
  • dbt test Executes the tests you defined for your project

For information on all dbt commands and their arguments (flags), see the dbt command reference. If you want to list all dbt commands from the command line, run dbt --help. To list a dbt command’s specific arguments, run dbt COMMAND_NAME --help .