Reference
Platform reference
Platform-injected environment variables, domains, and CLI configuration files.
CLI configuration
| Path | Purpose |
|---|---|
.bytstack/config.json | Linked serviceId, optional projectId / apiUrl |
~/.bytstack/credentials.json | Stored API token after bytstack login |
Environment overrides:
| Variable | Purpose |
|---|---|
BYTSTACK_API_URL | Control plane API base URL |
BYTSTACK_TOKEN | API token (overrides stored credentials) |
Workload environment
Injected into running services (names may grow over releases):
| Variable | Purpose |
|---|---|
PORT | HTTP port for web services |
NODE_ENV | Runtime environment |
DATABASE_URL | Internal Postgres URL when attached |
BYTSTACK_SERVICE_ID | Service identifier |
BYTSTACK_DEPLOYMENT_ID | Deployment identifier |
BYTSTACK_APEX_HOST | Apex host for SaaS / path routing |
BYTSTACK_API_PATH | API path prefix for path-split apps |
BYTSTACK_EDGE_TARGET | Edge routing metadata |
Domains
| Kind | Typical pattern |
|---|---|
| Platform app URL | *.bytstack.app |
| Marketing | bytstack.com |
| External Postgres | *.postgres.bytstack.app |
| Internal DB DNS | *.internal.bytstack |
Local/dev hostnames may use bytstack.local depending on your cluster setup.
Deploy statuses
queued → cloning → building → publishing → releasing → live (or a failure terminal state).