Skip to content

Environment variables

Everything can be set in the app. Environment variables override saved keys, which is useful if you don’t want a key stored by Relay.

Relay only sees variables in the environment it was started with. When the desktop app opens from the Dock, Finder or at login, it picks up your shell’s PATH but not other variables from your shell profile, and it doesn’t read .env files. Start it from a terminal to pass keys this way, for example /Applications/Relay.app/Contents/MacOS/Relay on macOS.

Any key the app asks for can come from the environment instead. A key set this way shows as “from environment” in the app and can’t be edited there.

Variable
SLACK_BOT_TOKEN Slack bot token (xoxb-…).
SLACK_APP_TOKEN Slack app-level token (xapp-…).
LINEAR_API_KEY Linear API key for Relay’s account.
CLICKUP_API_TOKEN ClickUp API token for Relay’s account.
ANTHROPIC_API_KEY
OPENAI_API_KEY
GOOGLE_GENERATIVE_AI_API_KEY
MISTRAL_API_KEY
GROQ_API_KEY
XAI_API_KEY
DEEPSEEK_API_KEY
OPENROUTER_API_KEY
OPENAI_COMPATIBLE_API_KEY For an OpenAI-compatible server.
ASC_KEY_ID, ASC_ISSUER_ID, ASC_PRIVATE_KEY App Store Connect API key.
PLAY_SERVICE_ACCOUNT Google Play service account JSON.