# dbt

Integrate, catalog, and govern dbt assets in Atlan.

## Required permissions

- [Preflight checks for dbt](https://docs.atlan.com/llms/connectors/dbt/preflight-checks-for-dbt/llms.txt): This checks if manifest files are present in the provided bucket and prefix.

## Setup options

- [Set up dbt Cloud](https://docs.atlan.com/llms/connectors/dbt/set-up-dbt-cloud/llms.txt): Configure authentication tokens in dbt Cloud to enable Atlan to fetch and enrich your assets with dbt metadata.
- [Set up dbt Core](https://docs.atlan.com/llms/connectors/dbt/set-up-dbt-core/llms.txt): Configure access and storage for dbt Core in Atlan, including credential setup for AWS, GCP, and Azure, and uploading dbt metadata files.
- [Connect dbt Cloud with API token](https://docs.atlan.com/llms/connectors/dbt/connect-dbt-cloud-with-an-api-token/llms.txt): Point Atlan at your dbt Cloud account using a token - four phases including the IP-restrictions network step most guides skip.
- [Connect dbt Core via storage bucket](https://docs.atlan.com/llms/connectors/dbt/connect-dbt-core-via-a-storage-bucket/llms.txt): Connect dbt Core to Atlan - your pipeline uploads dbt's output files to a cloud bucket (S3, GCS, ADLS, or Atlan-managed) and Atlan reads them.
- [Allowlists and firewalls](https://docs.atlan.com/llms/connectors/dbt/allowlists-and-firewalls/llms.txt): Everything IP- and firewall-related for dbt - dbt Cloud's IP restrictions feature, and storage-side firewalls for dbt Core buckets.

## Crawl and mine

- [Crawl dbt](https://docs.atlan.com/llms/connectors/dbt/crawl-dbt/llms.txt): Configure and run the crawler to extract metadata from your dbt Cloud or dbt Core projects.
- [Manage dbt tags](https://docs.atlan.com/llms/connectors/dbt/manage-dbt-tags/llms.txt): Atlan imports your dbt tags and lets you update your dbt assets with the imported tags.
- [Enrich Atlan through dbt](https://docs.atlan.com/llms/connectors/dbt/update-atlan-through-dbt/llms.txt): Beyond the default mapped dbt Cloud or dbt Core properties, you can update any of Atlan's metadata attributes (except for `name`, `tenantId`, and `qualifiedName`) through your dbt model's `meta` property.
- [Migrate from dbt to Atlan action](https://docs.atlan.com/llms/connectors/dbt/migrate-from-dbt-to-atlan-action/llms.txt): Atlan's atlan-action extends the former dbt-action with broader dbt-to-Atlan capabilities in CI.

## Reference

- [Choose how Atlan connects to dbt](https://docs.atlan.com/llms/connectors/dbt/choose-how-atlan-connects-to-dbt/llms.txt): Compare the two ways Atlan can read your dbt metadata - the dbt Cloud API with a token, or dbt output files in a cloud storage bucket for dbt Core.
- [How dbt connectivity works](https://docs.atlan.com/llms/connectors/dbt/how-dbt-connectivity-works/llms.txt): Learn the three traffic paths between your dbt setup and Atlan - the dbt Cloud API pull, the storage-bucket read, and your own upload pipeline.
- [Add impact analysis in GitHub](https://docs.atlan.com/llms/connectors/dbt/add-impact-analysis-in-github/llms.txt): Learn about add impact analysis in github.
- [Add impact analysis in GitLab](https://docs.atlan.com/llms/connectors/dbt/add-impact-analysis-in-gitlab/llms.txt): Learn about add impact analysis in gitlab.
- [What does Atlan crawl from dbt Cloud?](https://docs.atlan.com/llms/connectors/dbt/what-does-atlan-crawl-from-dbt-cloud/llms.txt)
- [What does Atlan crawl from dbt Core?](https://docs.atlan.com/llms/connectors/dbt/what-does-atlan-crawl-from-dbt-core/llms.txt)
- [Special cases](https://docs.atlan.com/llms/connectors/dbt/special-cases/llms.txt): dbt special cases - multiple environments, token rotation, Core migration, managed buckets, shared IAM roles, Cloud and Core in parallel.
- [dbt assets package](https://docs.atlan.com/llms/connectors/dbt/package-reference/llms.txt): Programmatically crawl and manage dbt assets in Atlan using the Python SDK (pyatlan). Reference for the dbt assets package.
- [dbt assets app](https://docs.atlan.com/llms/connectors/dbt/dbt-sdk-references-app-reference/llms.txt): Learn how to crawl dbt assets (dbt Cloud or dbt Core) and publish them to Atlan.

## Troubleshooting

- [Troubleshooting dbt connectivity](https://docs.atlan.com/llms/connectors/dbt/troubleshooting-dbt-connectivity/llms.txt): Symptom-first troubleshooting for dbt connectivity - bucket access denied, dbt Cloud access forbidden, AssumeRole failures, wrong hosts, and stale catalogs.