DbtHow-ToBeginner · 3 min read

How to Use dbt deps Command: Syntax and Examples

Use the dbt deps command to download and install dependencies listed in your packages.yml file into your dbt project. This command fetches external packages so you can use their models and macros in your project.

📐

Syntax

The basic syntax of the dbt deps command is simple and does not require additional arguments. It reads the packages.yml file in your project directory and installs the specified packages.

dbt deps: Installs all dependencies listed in packages.yml.

bash

dbt deps

💻

Example

This example shows how to use dbt deps to install dependencies defined in packages.yml. After running the command, dbt downloads the packages into the dbt_modules folder.

bash

echo "packages:
  - package: dbt-labs/dbt_utils
    version: 0.8.6" > packages.yml

dbt deps

Output

Installing dbt-labs/dbt_utils Installed dbt-labs/dbt_utils 0.8.6

⚠️

Common Pitfalls

Common mistakes when using dbt deps include:

Not having a packages.yml file or having syntax errors in it.
Forgetting to run dbt deps after adding or changing dependencies.
Running dbt deps outside the project directory where packages.yml is located.

Always ensure your packages.yml is valid YAML and located in your project root.

bash

## Wrong: No packages.yml file
$ dbt deps
# Error: Could not find packages.yml

## Right: Create packages.yml and run dbt deps
$ echo "packages:\n  - package: dbt-labs/dbt_utils\n    version: 0.8.6" > packages.yml
$ dbt deps
Installing dbt-labs/dbt_utils
  Installed dbt-labs/dbt_utils 0.8.6

📊

Quick Reference

Command	Description
dbt deps	Installs all dependencies from packages.yml
dbt deps --help	Shows help information about dbt deps command
Modify packages.yml	Add or update packages to manage dependencies
Delete dbt_modules folder	Remove installed packages to force fresh install

✅

Key Takeaways

Run dbt deps to install all dependencies listed in your packages.yml file.

Always keep your packages.yml file valid and in your project root directory.

Run dbt deps after adding or updating packages to download them.

Dependencies are installed into the dbt_modules folder inside your project.

If dependencies fail to install, check your packages.yml syntax and project location.