Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
Create one or more Environment Manager environment variables.
--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.
astro env variable create
| 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 |
# 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
Was this page helpful?