How to Use dbt debug
Last updated July 25, 2026 · By the SaturnSQL team
dbt debug validates your setup: it checks the dbt version, dbt_project.yml, profiles.yml, required dependencies, and runs a live connection test against the warehouse. It is the first command to run when dbt cannot connect or cannot find a profile.
dbt debug
dbt debug --config-dir # print where dbt looks for profiles.ymlReading the output
Each check prints OK or ERROR. A failed "connection test" with valid files means bad credentials, network, or warehouse permissions; "Could not find profile" means the profile: name in dbt_project.yml does not match any profile in profiles.yml.
Run this in SaturnSQL
SaturnSQL is a browser-based SQL editor for teams: shared query library, schema-aware autocomplete, and scheduled exports to Google Sheets and Slack.
Try it free