Environment variables
Variables used by the console build, fleet agent, and local development.
Console (Vite) — build time
Set in .env.production, .env.development, or CI from SSM.
| Variable | Purpose |
|---|---|
VITE_CONSTELLATION_API_URL | Direct OS API base; enables "Live API" mode |
VITE_COGNITO_DOMAIN | Cognito hosted UI domain |
VITE_COGNITO_CLIENT_ID | OAuth app client id |
VITE_COGNITO_REDIRECT_URI | OAuth callback URL |
VITE_CHAT_API_URL | Assistant Lambda/API endpoint |
VITE_BILLING_API_URL | Stripe billing Lambda endpoint |
Local dev proxy
| Variable | Purpose |
|---|---|
CONSTELLATION_API_URL | Target for osApiProxy (e.g. http://localhost:8000) |
Fleet agent / integrations
| Variable | Purpose |
|---|---|
CONSTELLATION_API_TOKEN | Bearer token for API calls |
CONSTELLATION_CONFIG_DIR | Config directory (default ~/.constellation) |
Docs site (CI deploy)
| Variable | Purpose |
|---|---|
DOCS_S3_BUCKET | S3 bucket for static docs |
DOCS_CF_DISTRIBUTION_ID | CloudFront distribution ID |
DOCS_CF_ALIAS | Alias for distribution lookup (default docs.constellation.space) |
GitHub Actions (console deploy)
See .github/ENVIRONMENTS.md: CONSOLE_*_BUCKET, CONSOLE_*_ALIAS, CONSOLE_*_CF_DISTRIBUTION_ID, CONSOLE_AWS_ROLE_ARN.
Example .env.local
VITE_CONSTELLATION_API_URL=http://localhost:8000
CONSTELLATION_API_URL=http://localhost:8000