Skip to content
Latchkey

dbt "Installed version not compatible with required_dbt_version" in CI

dbt_project.yml declares a require-dbt-version range and the dbt installed on the runner is outside it. dbt refuses to run so a project is never built with an unsupported version.

What this error means

dbt fails at startup with "Runtime Error: This version of dbt is not supported ... Installed version X is not compatible with required_dbt_version Y".

dbt
Runtime Error
  This version of dbt is not supported with the 'my_project' package.
  Installed version of dbt is 1.5.0
  Required version is >=1.7.0,<1.9.0

Common causes

CI installed a dbt outside the required range

The runner installed a dbt version (often unpinned) that does not satisfy require-dbt-version in dbt_project.yml.

The adapter pulled a different core version

An adapter pin resolved a dbt-core outside the project range, so the versions no longer match.

How to fix it

Pin dbt to a version in the required range

  1. Read the required range in the error.
  2. Pin the adapter (which pins core) to a version inside it.
  3. Reinstall and run dbt --version to confirm.
Terminal
pip install "dbt-snowflake>=1.7,<1.9"

Align require-dbt-version with what CI installs

Keep the project pin and the installed version consistent so CI never runs an unsupported dbt.

dbt_project.yml
# dbt_project.yml
require-dbt-version: [">=1.7.0", "<1.9.0"]

How to prevent it

  • Pin the dbt adapter version in CI to satisfy require-dbt-version.
  • Keep require-dbt-version and the installed version in sync.
  • Run dbt --version in CI to surface drift early.

Related guides

Tired of flaky CI? Latchkey auto-heals failed jobs and retries them for you. Start free →