Environment Variables

This is a concise reference. See Configuration for explanations and recommended usage.

Runtime

VariableDefault
PORT3001 server, 0 desktop
DATABASE_PATH./openvibely.db or app-data path
DATABASE_URLempty
ENVIRONMENTdevelopment
PROJECT_REPO_ROOT./repos or app-data path
OPENVIBELY_APP_DATA_DIRempty unless set
OPENVIBELY_ENABLE_LOCAL_REPO_PATHfalse server, true desktop when unset
OPENVIBELY_PLUGIN_ROOTapp-local plugin root when unset
OPENVIBELY_CODEX_REASONING_EFFORThigh fallback

Auth

VariableDefault
AUTH_ENABLEDinferred from username/password when unset
AUTH_USERNAMEempty
AUTH_PASSWORDempty
AUTH_SESSION_SECRETempty
AUTH_SESSION_TTL24h

OAuth And Providers

Variable GroupExamples
Base URL and redirectAPP_BASE_URL, OAUTH_REDIRECT_MODE
Anthropic OAuthANTHROPIC_OAUTH_CLIENT_ID, ANTHROPIC_OAUTH_CLIENT_SECRET, authorize/token URL, scopes
OpenAI OAuthOPENAI_OAUTH_CLIENT_ID, OPENAI_OAUTH_CLIENT_SECRET, authorize/token URL, scopes
Provider bootstrapANTHROPIC_API_KEY

Channels

ChannelVariables
TelegramTELEGRAM_BOT_TOKEN
GitHubGITHUB_APP_ID, GITHUB_APP_SLUG, GITHUB_APP_PRIVATE_KEY
SlackSLACK_CLIENT_ID, SLACK_CLIENT_SECRET, SLACK_APP_TOKEN, SLACK_BOT_TOKEN

Git SSL