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

# dbt via GitHub

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 currently requires that you 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:

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.