> ## 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 env variable create

> Create one or more Environment Manager environment variables.

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

Create a single environment variable with `--key` and `--value`, or bulk-create variables from a dotenv file with `--from-file`. When you use `--from-file`, the `--secret` and `--auto-link` flags apply to every entry in the file.

## Usage

```bash wrap theme={null}
astro env variable create
```

## Options

| Option | Description | Possible Values |
| - | - | - |
| `-k`,`--key` | The variable key. Required unless you use `--from-file`. | Any string |
| `-v`,`--value` | The variable value. If omitted, the CLI reads the value from stdin when piped, or prompts for it with the input hidden. | Any string |
| `-s`,`--secret` | Mark the variable as secret. | None |
| `--from-file` | Bulk-create variables from a dotenv file with one `KEY=VALUE` per line. Pass `-` to read from stdin. Mutually exclusive with `--key` and `--value`. | Any valid file path, or `-` |
| `--auto-link` | Workspace scope only. Automatically link the variable to all Deployments in the Workspace, including future ones. | None |
| `--workspace-id` | Set the Workspace scope. Mutually exclusive with `--deployment-id`. Defaults to your current Workspace from CLI context. | Any valid Workspace ID |
| `--deployment-id` | Set the Deployment scope. Mutually exclusive with `--workspace-id`. | Any valid Deployment ID |

## Examples

```bash wrap theme={null}
# Create a Workspace variable
astro env variable create --workspace-id <workspace-id> --key DBT_PROFILES_DIR --value /opt/profiles

# Create a secret Workspace variable and auto-link it to every Deployment
astro env variable create --workspace-id <workspace-id> --key API_TOKEN --value $TOKEN --secret --auto-link

# Bulk-create variables from a dotenv file
astro env variable create --workspace-id <workspace-id> --from-file .env
```

## Related commands

* [`astro env variable update`](/docs/cli/v1.46/astro-env-variable-update)
* [`astro env variable list`](/docs/cli/v1.46/astro-env-variable-list)
* [`astro env variable export`](/docs/cli/v1.46/astro-env-variable-export)