> For the complete documentation index, see [llms.txt](https://canvasapp.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://canvasapp.gitbook.io/docs/getting-started/connecting-your-data/dbt/dbt-via-github.md).

# dbt via GitHub

Connect dbt via GitHub to sync your metadata

If you do not use `dbt` Cloud, Canvas can download and compile your `dbt` project to generate the descriptions for your models and columns. This requires you to host your `dbt` project on Github and give Canvas access to your repository via OAuth.

Once you've granted Canvas access via OAuth, you must select the following:

1. The repository containing your `dbt` project
2. The branch of the repository that you'd like Canvas to build with (usually `master` or `main`)
3. The schema in your warehouse that your `dbt` models build into. `dbt` requires this access to compile your project.