astro run

The behavior and format of this command are the same for both Astro and Astro Private Cloud.

Trigger a single dag run in a local Airflow environment and see task success or failure in your terminal. This command compiles your dag and runs it in a single Airflow worker container based on your Astro project configurations. For more information, see Test your Astro project locally.

Usage

astro run <dag-id>

Options

Option	Description	Possible Values
`-d`, `--dag-file`	The location of your dag file. When you specify this flag, only the specified dag is parsed by the Astro CLI. All other dags in the project are ignored.	Any valid dag file in your `dags` directory.
`-e`,`--env`	Path to an alternative environment variable file. The default is `.env` in your current Astro project.	Any valid filepath.
`--execution-date`	The execution date for the dag run.	An execution date formatted as either `YYYY-MM-DD`, `YYYY-MM-DDTHH:MM:SS`. or `YYYY-MM-DD HH:MM:SS`.
`--no-cache`	Build your Astro project into a Docker image without using cache.	None.
`-s`, `--settings-file`	An alternative settings file from which Airflow objects are imported. The default is `airflow_settings.yaml` in your current Astro project.	Any valid filepath.

Examples

# Run a dag with an alternative set of environment variables
$ astro run example_dag_basic --env dev.env

Overview

Install the CLI

Develop with the CLI

Configure the CLI

Release information

Archived versions

Usage

Options

Examples

​Usage

​Options

​Examples

​Related commands

Usage

Options

Examples

Related commands