Environment Variables
Complete reference of environment variables used across the Subscriberbot ecosystem.
Primary selector
| Variable | Values | Default | Description |
|---|---|---|---|
BURDENOFF_ENV | local | alpha | prod | prod | Selects the target environment for all tooling. Read at runtime (CLI, SDK, app) or build time (browser extension). |
CLI
| Variable | Default | Description |
|---|---|---|
SUBSCRIBERBOT_WORKSPACE_ENDPOINT | Derived from BURDENOFF_ENV | Workspace gateway GraphQL endpoint |
SUBSCRIBERBOT_GLOBAL_ENDPOINT | Derived from BURDENOFF_ENV | Global gateway GraphQL endpoint |
SUBSCRIBERBOT_OIDC_ISSUER | Derived from BURDENOFF_ENV | OIDC issuer URL |
SUBSCRIBERBOT_CLIENT_ID | burdenoff_cli_subscriberbot | OAuth2 client id |
SUBSCRIBERBOT_CLIENT_SECRET | — | OAuth2 client secret (client credentials flow) |
Node SDK
| Variable | Default | Description |
|---|---|---|
SUBSCRIBERBOT_WORKSPACE_ENDPOINT | — | Workspace gateway GraphQL endpoint (constructor takes precedence) |
SUBSCRIBERBOT_GLOBAL_ENDPOINT | — | Global gateway GraphQL endpoint (constructor takes precedence) |
SUBSCRIBERBOT_API_KEY | — | API key authentication |
SUBSCRIBERBOT_ACCESS_TOKEN | — | Pre-existing access token |
SUBSCRIBERBOT_REFRESH_TOKEN | — | Pre-existing refresh token |
SUBSCRIBERBOT_WORKSPACE_TOKEN | — | Pre-existing workspace token |
Python SDK
| Variable | Default | Description |
|---|---|---|
SUBSCRIBERBOT_WORKSPACE_ENDPOINT | — | Workspace gateway GraphQL endpoint (constructor takes precedence) |
SUBSCRIBERBOT_GLOBAL_ENDPOINT | — | Global gateway GraphQL endpoint (constructor takes precedence) |
MCP Server
| Variable | Default | Description |
|---|---|---|
SUBSCRIBERBOT_WORKSPACE_ENDPOINT | https://graphqlworkspaces.burdenoff.com/workspaces/graphql | Workspace gateway |
SUBSCRIBERBOT_GLOBAL_ENDPOINT | https://graphql.burdenoff.com/global/graphql | Global gateway |
SUBSCRIBERBOT_API_KEY | — | API key auth (skips device code) |
SUBSCRIBERBOT_ACCESS_TOKEN | — | Pre-set access token |
SUBSCRIBERBOT_WORKSPACE_ID | — | Pre-select workspace |
SUBSCRIBERBOT_ORGANIZATION_ID | — | Pre-select organization |
LOG_LEVEL | info | Logging level (error/warn/info/debug) |
Browser Extension (build time)
| Variable | Default | Description |
|---|---|---|
BURDENOFF_ENV | prod | Selects endpoints baked into the webpack bundle |
VS Code Extension (runtime)
| Variable | Default | Description |
|---|---|---|
BURDENOFF_ENV | prod | Resolved at VS Code launch time in src/env.ts |
App Shell (build time)
| Variable | Default | Description |
|---|---|---|
BURDENOFF_ENV | prod | Selects gateway base URLs baked into Vite build |
VITE_WSPACE_GATEWAY_URL | Derived from BURDENOFF_ENV | Workspace gateway base URL (no path) |
VITE_GLOBAL_GATEWAY_URL | Derived from BURDENOFF_ENV | Global gateway base URL (no path) |
Doctor E2E
| Variable | Default | Description |
|---|---|---|
SUBSCRIBERBOT_TARGET | prod | Target environment: prod, alpha, local |
SUBSCRIBERBOT_ENDPOINT | — | Direct endpoint override (takes precedence) |
AUTH_TOKEN | — | Platform JWT for alpha/prod runs |
WORKSPACE_TOKEN | — | Workspace JWT for alpha/prod runs |
WORKSPACE_ID | — | Workspace UUID for alpha/prod runs |
USER_ID | — | User UUID for alpha/prod runs |
CF_ACCESS_CLIENT_ID | — | Cloudflare Access client id (alpha only) |
CF_ACCESS_CLIENT_SECRET | — | Cloudflare Access client secret (alpha only) |
Backend Service (local dev)
| Variable | Default | Description |
|---|---|---|
DATABASE_URL | — | PostgreSQL connection string |
REDIS_URL | — | Valkey/Redis connection string |
PORT | 3291 | HTTP server port |
HIVE_TOKEN | — | GraphQL Hive CLI token |
Endpoint defaults by environment
| Environment | Workspace gateway | Global gateway | OIDC issuer |
|---|---|---|---|
prod | https://graphqlworkspaces.burdenoff.com/workspaces/graphql | https://graphql.burdenoff.com/global/graphql | https://graphql.burdenoff.com/global |
alpha | https://alphagraphqlworkspaces.burdenoff.com/workspaces/graphql | https://alphagraphql.burdenoff.com/global/graphql | https://alphagraphql.burdenoff.com/global |
local | http://localhost:4003/workspaces/graphql | http://localhost:4000/global/graphql | http://localhost:4000/global |
Related
- Environment Selection — detailed per-component usage.
- Auth — token management and OAuth2 flows.