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.0Common 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
- Read the required range in the error.
- Pin the adapter (which pins core) to a version inside it.
- Reinstall and run
dbt --versionto 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 --versionin CI to surface drift early.
Related guides
dbt adapter not installed (dbt-snowflake / dbt-bigquery) in CIFix dbt "Runtime Error: Could not find adapter type snowflake" in CI - the adapter package (dbt-snowflake, db…
dbt "deps ... could not resolve" packages.yml in CIFix dbt deps failures in CI - packages.yml requests a package or version that dbt cannot resolve from the hub…
dbt "Credentials in profile target invalid" in CIFix dbt "Credentials in profile ..., target ... invalid" in CI - profiles.yml is missing a required connectio…