Skip to main content

About dbt --version

The --version command-line flag returns information about the currently installed version of dbt Core, the dbt CLI, or the dbt Fusion engine. This flag is not supported when invoking dbt in other dbt runtimes (for example, the IDE or scheduled runs).

  • dbt Core — Returns the installed version of dbt Core and the versions of all installed adapters.
  • dbt CLI — Returns the installed version of the dbt CLI and, for the other dbt_version values, the latest version of the dbt runtime in dbt.
  • dbt Fusion engine — Returns the installed Fusion version. Because the CLI and language server ship in a single binary, they always report the same version. Refer to Version compatibility for how this maps to the dbt VS Code extension.

Versioning​

To learn more about release versioning for dbt Core, refer to How dbt Core uses semantic versioning.

If using a dbt release track, which provide ongoing updates to dbt, then dbt_version represents the release version of dbt in dbt. This also follows semantic versioning guidelines, using the YYYY.M.D+<suffix> format. The year, month, and day represent the date the version was built (for example, 2024.10.8+996c6a8). The suffix provides an additional unique identification for each build.

Example usages​

dbt Core example:

dbt Core
$ dbt --version
Core:
  - installed: 1.7.6
  - latest:    1.7.6 - Up to date!
Plugins:
  - snowflake: 1.7.1 - Up to date!

dbt CLI example:

dbt CLI
$ dbt --version
Cloud CLI - 0.35.7 (fae78a6f5f6f2d7dff3cab3305fe7f99bd2a36f3 2024-01-18T22:34:52Z)

dbt Fusion engine example:

$ dbt --version
dbt-fusion 2.0.0-preview.92

For a machine-readable version, add the --format json flag. This is useful when filing a bug report or when tooling needs to parse the installed version:

dbt --version --format json
{
  "version": "2.0.0-preview.92"
}

Was this page helpful?

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

0
Loading