For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
      • AstroFully-managed data operations, powered by Apache Airflow.
      • Astro Private CloudRun Airflow-as-a-service in your environment.
      • Professional ServicesExpert Airflow services for your enterprise's success.
    • Tools
      • Cosmos
      • Orbiter
      • CLI
      • AI SDK
      • Agents
      • Blueprint
      • UpdatesThe State of Airflow 2026See the insights from over 5,800 data practitioners in the full report. Download Now ➔
  • Customers
  • Docs
    • Insights
      • Blog
      • Webinars
      • Resource Library
      • Events
    • Education
      • Academy
      • What is Airflow?
  • Pricing
Get Started Free
    • Astro CLI
    • Quickstart
    • CLI reference
      • astro completion
      • astro api
      • astro auth
      • astro config
      • astro context
      • astro dbt
        • astro dbt delete
        • astro dbt deploy
      • astro deploy
      • astro deployment
      • astro dev
      • astro ide
      • astro login
      • astro logout
      • astro organization
      • astro otto
      • astro remote
      • astro run
      • astro team
      • astro telemetry
      • astro user create
      • astro version
      • astro workspace

Product

  • Platform Overview
  • Astro
  • Astro Observe
  • Astro Private Cloud
  • Security & Trust
  • Pricing

Tools & Services

  • Cosmos
  • Docs
  • Professional Services
  • Product Updates

Use Cases

  • AI Ops
  • Data Observability
  • ETL/ELT
  • ML Ops
  • Operational Analytics
  • All Use Cases

Industries

  • Financial Services
  • Gaming
  • Retail
  • Manufacturing
  • Healthcare
  • All Industries

Resources

  • Academy
  • eBooks & Guides
  • Blog
  • Webinars
  • Events
  • The Data Flowcast Podcast
  • All Resources

Airflow

  • What is Airflow
  • Airflow on Astro
  • Airflow 3.0
  • Airflow Upgrades
  • Airflow Use Cases
  • Airflow 2.x End of Life

Company

  • Our Story
  • Customers
  • Newsroom
  • Careers
  • Contact

Support

  • Knowledge Base
  • Status
  • Contact Support
GitHubYouTubeLinkedInx
  • Legal
  • Privacy
  • Terms of Service
  • Consent Preferences

  • Do Not Sell or Share My Personal information
  • Limit the Use Of My Sensitive Personal Information

Apache Airflow®, Airflow, and the Airflow logo are trademarks of the Apache Software Foundation. Copyright © Astronomer 2026. All rights reserved.

LogoLogo
CLI referenceastro dbt

astro dbt deploy

Edit this page
Built with
This command is only available on Astro.

This command allows you to deploy your dbt code directly to Astro, independently of any dag deploys or full project image deploys.

This command bundles all files in your dbt project and pushes them to Astro, where they are mounted on your Airflow containers so that your dags can access them.

When you run astro dbt deploy, the CLI prompts you to select from a list of all Deployments that you can access across Workspaces. To bypass this prompt, you can also specify a Deployment ID in the command. To retrieve a Deployment ID, open your Deployment in the Astro UI and copy the value in the ID section of the Deployment page. You can also run astro deployment list to find a Deployment ID or name.

Usage

$astro dbt deploy <your-deployment-id> <options>

Options

OptionDescriptionPossible Values
-n, --deployment-nameName of the Deployment to deploy your dbt project toAny valid Deployment name
--descriptionDescription of the project to store on the deployString
-m, --mount-pathPath describing where to mount the dbt project in Airflow, so that it is accessible to your dags. Default path is /usr/local/airflow/dbt/<dbt-project-name>Any valid path except /usr/local/airflow/dags, which is used for dag deploys
-p, --project-pathPath to the dbt project that you want to deploy. The default is your current directoryAny valid filepath to a dbt project
-w, --waitWait for the Deployment to become healthy before ending the deploy command. Default is FalseTrue or False
--wait-timeTime to wait for the Deployment to become healthy before ending the command. Can only be used with --wait=true.A time duration amount, such as 10s or 1m11s.
--workspace-idThe Workspace ID for the Deployment where you want to deploy your dbt projectAny valid Workspace ID

Examples

To deploy directly to a specific Deployment:

$astro dbt deploy clyxf7lfs000108jtcs4b59nm

to deploy a project to a specific deployment on the mount path, example-path.

$astro dbt deploy clyxf7lfs000108jtcs4b59nm --mount-path="/usr/local/airflow/dbt/test-dbt-project"

Related commands

  • astro dbt delete
  • astro deployment list

See also

  • Webinar: Introducing Cosmos: The Easy Way to Run dbt Models in Airflow.
  • Demo: See how to deploy your dbt projects to Astro