> ## Documentation Index
> Fetch the complete documentation index at: https://astronomer.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# astro dbt deploy

<Info>
  This command is only available on Astro.
</Info>

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

```bash wrap theme={null}
astro dbt deploy <your-deployment-id> <options>
```

## Options

| Option                    | Description                                                                                                                                                   | Possible Values                                                                 |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| `-n`, `--deployment-name` | Name of the Deployment to deploy your dbt project to                                                                                                          | Any valid Deployment name                                                       |
| `--description`           | Description of the project to store on the deploy                                                                                                             | String                                                                          |
| `-m`, `--mount-path`      | Path 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-path`    | Path to the dbt project that you want to deploy. The default is your current directory                                                                        | Any valid filepath to a dbt project                                             |
| `-w`, `--wait`            | Wait for the Deployment to become healthy before ending the deploy command. Default is `False`                                                                | `True` or `False`                                                               |
| `--wait-time`             | Time 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-id`          | The Workspace ID for the Deployment where you want to deploy your dbt project                                                                                 | Any valid Workspace ID                                                          |

## Examples

To deploy directly to a specific Deployment:

```bash wrap theme={null}
astro dbt deploy clyxf7lfs000108jtcs4b59nm
```

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

```bash wrap theme={null}
astro dbt deploy clyxf7lfs000108jtcs4b59nm --mount-path="/usr/local/airflow/dbt/test-dbt-project"
```

## Related commands

* [`astro dbt delete`](/docs/cli/v1.38/astro-dbt-delete)
* [`astro deployment list`](/docs/cli/v1.38/astro-deployment-list)

## See also

* Webinar: [Introducing Cosmos: The Easy Way to Run dbt Models in Airflow](https://www.astronomer.io/events/webinars/introducing-cosmos-the-east-way-to-run-dbt-models-in-airflow/).
* Demo: [See how to deploy your dbt projects to Astro](https://www.astronomer.io/dbt-demo/)