Skip to content

Environment Variables

Configure Teleos with a .env file next to docker-compose.yml (teleos up writes one for you). Never commit it.

VariableDescription
GITHUB_TOKENRead-only GitHub token. The launcher fills it from gh auth token; on a server use a read-only fine-grained token
SECRET_KEYLong random string for signing sessions. Generate once; keep it secret
DEBUGSet to false on any server
ALLOWED_HOSTSComma-separated hostnames Teleos answers to
CSRF_TRUSTED_ORIGINSOrigins allowed to submit forms, e.g. https://teleos.example.com
VariableDefaultDescription
PORT8000Host port
LOG_LEVELINFODEBUG, INFO, WARNING or ERROR
SCHEDULER_ENABLEDtrueBackground sync schedule
DATABASE_PATHset by composeSQLite file location inside the container
TELEOS_SIGNATURES_PATHbundledUse a newer agent-signature definitions file without upgrading
TELEOS_TIER / TELEOS_LICENSE_KEYLicensed tier (pilot: not enforced)
GITHUB_APP_ID, GITHUB_APP_PRIVATE_KEY or GITHUB_APP_PRIVATE_KEY_PATHGitHub App credentials (in progress)
VariableDescription
DISABLE_AUTHSkip the login screen. Requires DEBUG=true; Teleos refuses to start otherwise. Only applies to requests from this machine
TELEOS_DEV_USERWhich user DISABLE_AUTH signs you in as; switch per session with ?dev_as=<username>
Terminal window
python3 -c "import secrets; print(secrets.token_urlsafe(50))"