> ## 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 run

> Reference documentation for astro run.

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

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](/docs/cli/v1.46/test-your-astro-project-locally).

## Usage

```sh wrap theme={null}
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

```sh wrap theme={null}
# Run a dag with an alternative set of environment variables
$ astro run example_dag_basic --env dev.env
```

## Related commands

* [`astro dev start`](/docs/cli/v1.46/astro-dev-start)
* [`astro dev restart`](/docs/cli/v1.46/astro-dev-restart)
* [`astro dev stop`](/docs/cli/v1.46/astro-dev-stop)
* [`astro deploy`](/docs/cli/v1.46/astro-deploy)