Getting Started

Getting started with Deep Channel

February 2, 2023

← Back

Get set up in a few minutes

A profile is the definition of a warehouse and the targets you wish to use when working against that warehouse. Most companies have a single warehouse, but it’s possible to need to define multiple profiles.

A target is the specific credentials and warehouse details for a given profile. Because profiles can have multiple targets, you can quickly switch between different users or environments of the same profile inside Deep Channel:

Deep Channel will check for a profiles.yml in four places:

  1. The location of the DBT_PROFILES_DIR environment variable
  2. The root of the dbt project
  3. Any custom path set in your Settings (Settings > dbt > Custom profiles.yml path)
  4. In your home directory, at  ~/.dbt/profiles.yml

Create a profiles.yml file

If you don’t have one, you can create a new one in a few minutes.

If you don’t have a .dbt folder in your home directory, just create a new one:

mkdir ~/.dbt

And then create a profiles.yml file:

macOS and Linux:

touch ~/.dbt/profiles.yml


ni ~/.dbt/profiles.yml

With a blank profiles.yml, we can now open a project in Deep Channel. Open Deep Channel and select Open dbt Project, navigate to the folder that contains your dbt_project.yml file, and click Import.

Because your profiles.yml is empty, Deep Channel will show a Profiles error message in the Profile selector. Click this error message and then click Edit - you can then edit the profiles.yml inside Deep Channel.

Populate the profile.yml with a profile, one or more outputs, and its target.

Have questions, thoughts or feedback? We'd love to hear it - reach out to us at

Related resources
No resources found.

Level up your workflow