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.9+ installed on your machine. See the CLI Reference for details.

Overview of the Setup Process

  1. Login to dagctl — Organizations Overview

    Or set it up from an AI assistant instead of steps 1–4.

  2. Create a project — SQLMesh Projects | dbt Projects

  3. Deploy your project — Plans Overview
  4. Create and schedule your jobs — SQLMesh Jobs | dbt Jobs
  5. Monitor and track job executions — Observability

dbt users

The dagctl CLI is not required for dbt projects. Everything is managed through the web UI. With the default semantic version strategy, your dbt project needs a .dagctl/config.yaml file with a version field — see dbt Projects for details.