Skip to content

Getting Started with dagctl

What You'll Need

Before getting started, ensure you have:

  • A dagctl organization account (contact your administrator or create a new organization)
  • Access to your organization's dagctl web interface
  • A Git repository containing your SQLMesh or dbt project

SQLMesh users only: If you plan to use the dagctl CLI for local development, you'll also need Python 3.8+ installed on your machine. See the CLI Reference for details.

Overview of the Setup Process

  1. Login to dagctlOrganizations Overview
  2. Create a projectSQLMesh Projects | dbt Projects
  3. Deploy your projectPlans Overview
  4. Create and schedule your jobsSQLMesh Jobs | dbt Jobs
  5. Monitor and track job executionsObservability

dbt users

The dagctl CLI is not required for dbt projects. Everything is managed through the web UI. Your dbt project only needs a .dagctl/config.yaml file with a version field — see dbt Projects for details.