Configuration
Environment variables for the Cyborg7 daemon, agent providers, cloud relay, and asset storage.
Environment variables for Cyborg7. Copy packages/server/.env.example to packages/server/.env and fill in the values. In solo mode the daemon needs almost nothing — most variables only apply to connected (multi-user) mode and the cloud relay.
Daemon Core
| Variable |
Status |
Description |
Example |
PASEO_HOME |
optional |
Location for runtime state (agents, SQLite db, config). Defaults to ~/.cyborg7, isolated from Paseo.app |
~/.cyborg7 |
PASEO_LISTEN |
optional |
Daemon listen address. Can be host:port, a path, or unix:///path/to/socket |
127.0.0.1:6780 |
DATABASE_URL |
optional |
PostgreSQL connection string. Set it for connected (multi-user) mode; omit it to run solo on SQLite only |
postgres://user:pass@host:5432/cyborg7 |
CYBORG7_JWT_SECRET |
optional |
Secret used to sign internal relay auth tokens. Defaults to a public dev secret; the relay refuses to boot in production without a strong value |
<openssl rand -hex 32> |
Agent Providers
| Variable |
Status |
Description |
Example |
OPENAI_API_KEY |
optional |
For OpenAI-backed providers and Whisper STT / TTS, if used |
sk-... |
PASEO_CLAUDE_DEBUG |
optional |
Verbose Claude SDK stream logging (trace-level per-token logs) |
1 |
Cloud Relay
| Variable |
Status |
Description |
Example |
RELAY_HOST |
optional |
Bind host for the standalone relay server |
0.0.0.0 |
RELAY_PORT |
optional |
Port the relay listens on |
8787 |
RELAY_PUBLIC_URL |
optional |
Public URL clients and daemons use to reach the relay |
wss://relay.cyborg7.com |
CYBORG_CORS_ORIGINS |
optional |
Comma-separated allowed CORS origins for the relay HTTP/WS endpoint |
https://app.cyborg7.com |
CYBORG_APP_URL |
optional |
App URL used by the relay for links and redirects |
https://app.cyborg7.com |
REDIS_URL |
optional |
Redis URL for multi-instance relay pub/sub, rate limiting, and presence. Optional — a single relay instance does not need it |
redis://localhost:6379 |
Asset Storage (S3)
| Variable |
Status |
Description |
Example |
S3_ASSETS_BUCKET |
optional |
S3 bucket for workspace avatars and uploads (presigned URL upload) |
cyborg7-shared-assets |
S3_ASSETS_REGION |
optional |
AWS region of the assets bucket |
sa-east-1 |
S3_ASSETS_ACCESS_KEY_ID |
optional |
IAM access key for the assets bucket |
AKIA... |
S3_ASSETS_SECRET_ACCESS_KEY |
optional |
IAM secret key for the assets bucket |
SJT... |
CLOUDFRONT_DOMAIN |
optional |
CloudFront domain for serving signed asset URLs |
assets.cyborg7.com |
CLOUDFRONT_KEY_PAIR_ID |
optional |
CloudFront key pair ID for URL signing |
K1A2B3C4... |