Shuttle Configuration¶
Shuttle is configured entirely through environment variables. Required variables have no default and must be supplied (the cluster bootstrap injects them).
| Variable | Required | Default | Description |
|---|---|---|---|
| STARFORM_STARBASE_URL | Yes | — | Base URL of Starbase API |
| STARFORM_CLUSTER_ID | Yes | — | UUID identifying this cluster |
| STARFORM_REGION | Yes | — | Region identifier (e.g. nyc3) |
| STARFORM_AUTH_TOKEN_FILE | Yes | — | Path to bearer token file (from Secret) |
| STARFORM_SNAPSHOT_INTERVAL | No | 60s | Pod snapshot frequency |
| STARFORM_CAPACITY_INTERVAL | No | 60s | Capacity report frequency |
| STARFORM_RECONCILE_INTERVAL | No | 30s | Desired state pull frequency |
| STARFORM_LOG_LEVEL | No | info | Log level |
| STARFORM_METRICS_ADDR | No | :8080 | Metrics + health endpoint |