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

<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.38/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.38/astro-dev-start)
* [`astro dev restart`](/docs/cli/v1.38/astro-dev-restart)
* [`astro dev stop`](/docs/cli/v1.38/astro-dev-stop)
* [`astro deploy`](/docs/cli/v1.38/astro-deploy)