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_STATUS_INTERVAL | No | 10s | Rollout status report frequency (§25.4) |
| STARFORM_GC_MAX_DELETES | No | 10 | Delete-breaker absolute floor per tick (§20.3) |
| STARFORM_GC_MAX_DELETE_FRACTION | No | 0.20 | Delete-breaker fraction of managed services per tick (§20.3) |
| STARFORM_SNAPSHOT_BUFFER | No | 60 | Replay-buffer depth for undelivered snapshot batches (FR-081) |
| STARFORM_LOG_LEVEL | No | info | Log level |
| STARFORM_METRICS_ADDR | No | :8080 | Metrics + health endpoint |