Skip to content

Environment variables

VariableDefaultMeaning
IVORYOS_PORT8080port, when a script does not pass one to run()
IVORYOS_HOST0.0.0.0interface to listen on
IVORYOS_DATA_DIRlegacy locationsthe data folder: database, workflows, safety config, Cloud pairing, schema dump. IVORYOS_EDGE_HOME is the same setting under its older name.
IVORYOS_ALLOWED_HOSTSthis machine’s namesextra host names the page may be reached by, comma separated; * disables the check
IVORYOS_FRONTEND_DIRthe package’s own copy, else frontend/out in a checkoutthe built interface to serve
IVORYOS_SUPERVISEDunsetset by the desktop app: a restart exits with code 75 instead of re-executing
IVORYOS_CLOUD_URLthe hosted Cloudthe Cloud to pair with
CLOUD_TOKEN, CLOUD_DEVICE_ID, CLOUD_PAUSED, CLOUD_SYNC_WORKFLOWSwritten to .env by pairingthe pairing; CLOUD_SYNC_WORKFLOWS=always|manual is the workflow sync mode
IVORYOS_STATUS_INTERVAL_S300how often a quiet deck re-sends its status to Cloud
IVORYOS_CLOUD_COMING_SOONunsethide Cloud links in the interface (release mode)
IVORYOS_DEMO_TEST_DRIVERSunsetload the synthetic test drivers into example/demo.py
ANTHROPIC_API_KEYunsetread by the Claude provider of the assistant
VariableMeaning
IVORYOS_DESKTOP_HOMEa separate home folder for decks and settings (development)
IVORYOS_ENABLE_CLOUD1 turns Cloud on in a packaged build
IVORYOS_CLOUD_COMING_SOON1 shows the coming-soon state in development
IVORYOS_HUB_URLa different Automation Hub address (development)
IVORYOS_GITHUB_CLIENT_ID, IVORYOS_GITLAB_CLIENT_IDOAuth app ids for signing in to private repositories

Documented in cloud_frontend/.env.local.example. The mode is inferred: SUPABASE_URL set means hosted (Supabase + AWS IoT), unset means LAN (SQLite + built-in broker); IVORYOS_CLOUD_MODE overrides it.