--- title: "Alchemist Environment Variables — AVCodex Docs" description: "Alchemist Environment Variables — AVCodex documentation for AV integrators, programmers, and ops teams." lang: en json-ld: --- [](/) Solutions [Pricing](/pricing)[The Signal](/blog)[Resources](/resources) Learn [Free AI Assessment](/scorecard)[Get Started →](/pricing) [Documentation Home](/docs) Guides Getting Started - [The Alchemist Copilot](/docs/guides/the-alchemist-copilot) - [Choosing a Model](/docs/guides/choosing-a-model) - [Skills & Templates](/docs/guides/skills-and-templates) - [Pricing & Usage](/docs/guides/pricing-and-usage) - [Understanding Tokens](/docs/guides/understanding-tokens) - [Maximize AVCodex Capabilities](/docs/guides/maximize-avcodex-capabilities) Knowledge & Memory - [How Knowledge Sources Work](/docs/guides/how-knowledge-sources-work) - [Knowledge Retrieval Settings](/docs/guides/knowledge-retrieval-settings) - [User Memory](/docs/guides/user-memory) - [Consumer Brain](/docs/guides/consumer-brain) Agent Capabilities - [Image Recognition](/docs/guides/image-recognition) - [Image Generation](/docs/guides/image-generation) - [Video Generation](/docs/guides/video-generation) - [Deep Research and Deep Thinking](/docs/guides/deep-research-and-deep-thinking) - [Heartbeat (Proactive AI Outreach)](/docs/guides/heartbeat-proactive-ai-outreach) - [Database Connections](/docs/guides/database-connections) - [Agent-to-Agent Links](/docs/guides/agent-to-agent-links) - [Message Tagging](/docs/guides/message-tagging) - [Lead Generation Forms](/docs/guides/lead-generation-forms) - [Multilingual Apps](/docs/guides/multilingual-apps) - [Understanding Evaluations](/docs/guides/understanding-evaluations) Design & Experience - [Style Studio](/docs/guides/style-studio) - [Component Studio](/docs/guides/component-studio) - [HQ Profile](/docs/guides/hq-profile) - [Multiplayer Chat](/docs/guides/multiplayer-chat) - [Circles](/docs/guides/circles) - [Desktop Agent](/docs/guides/desktop-agent) Voice & Phone - [Phone Numbers](/docs/guides/phone-numbers) - [Outbound Calling](/docs/guides/outbound-calling) - [Voice Cloning](/docs/guides/voice-cloning) Publish & Share - [Embed Chat Widget](/docs/guides/embed-chat-widget) - [Custom Domains](/docs/guides/custom-domains) - [PWA Installation](/docs/guides/pwa-installation) - [AVCodex Sites](/docs/guides/avcodex-sites) - [Embed on Kajabi](/docs/guides/embed-on-kajabi) - [How to Use AVCodex with Claude Code](/docs/guides/how-to-use-avcodex-with-claude-code) Monetization & Access - [Selling Access](/docs/guides/selling-access) - [Consumer Monetization](/docs/guides/consumer-monetization) - [Access Control](/docs/guides/access-control) - [Bring Your Own Auth](/docs/guides/bring-your-own-auth) - [Clever SSO for Schools](/docs/guides/clever-sso-for-schools) Analytics & Operations - [Analytics & Chat History](/docs/guides/analytics-and-chat-history) - [Performance Dashboard](/docs/guides/performance-dashboard) - [Programmatic Usage Stats](/docs/guides/programmatic-usage-stats) - [Session Lifecycle Webhooks](/docs/guides/session-lifecycle-webhooks) - [Audit Logs](/docs/guides/audit-logs) Teams & White-Label - [Team Management](/docs/guides/team-management) - [Enterprise Whitelabel](/docs/guides/enterprise-whitelabel) Alchemist Platform - [Alchemist Tickets](/docs/guides/alchemist-tickets) - [Alchemist Getting Started](/docs/guides/alchemist-getting-started) - [Alchemist Working with Tickets](/docs/guides/alchemist-working-with-tickets) - [Alchemist Local Development](/docs/guides/alchemist-local-development) Alchemist Operations - [Alchemist Environment Variables](/docs/guides/alchemist-environment-variables) - [Alchemist Deploys and Domains](/docs/guides/alchemist-deploys-and-domains) - [Alchemist Self-Healing](/docs/guides/alchemist-self-healing) Alchemist API & Automation - [Alchemist API Keys](/docs/guides/alchemist-api-keys) - [Alchemist MCP Server](/docs/guides/alchemist-mcp-server) - [Alchemist Pipeline Configuration](/docs/guides/alchemist-pipeline-configuration) - [Alchemist Pipeline Permutations](/docs/guides/alchemist-pipeline-permutations) Developer Platform - [Building Custom MCP Servers](/docs/guides/building-custom-mcp-servers) - [Consumer OAuth for Custom MCP Servers](/docs/guides/consumer-oauth-for-custom-mcp-servers) AVCodex MCP Server - [Overview](/docs/guides/overview) - [MCP Reference](/docs/guides/mcp-reference) - [Setup & Installation](/docs/guides/setup-and-installation) - [Authentication](/docs/guides/authentication) - [Tools Reference](/docs/guides/tools-reference) - [Common Workflows](/docs/guides/common-workflows) - [Rate Limits](/docs/guides/rate-limits) Custom Actions Pro Actions API Builder API Agentic Commerce (ACP) Integrations [Docs](/docs)/ Guides / Alchemist Operations # Alchemist Environment Variables Last updated · MAR 2026 · [Read as Markdown](/docs/guides/alchemist-environment-variables.md) # Alchemist: Environment Variables Configure secrets and environment variables for your deployed Alchemist app. * * * The platform pre-injects a small set of credentials into every project so that storage, transactional email, and session signing work out of the box. You don't need to provision these yourself, and you should not hardcode alternative credentials in your code. ## [Pre-injected variables# ](#pre-injected-variables) Variable Purpose `JWT_SECRET` Per-project secret for signing session cookies. Used by the auth middleware. `R2_ENDPOINT`, `R2_BUCKET`, `R2_KEY_PREFIX`, `R2_ACCESS_KEY_ID`, `R2_SECRET_ACCESS_KEY` Cloudflare R2 (S3-compatible) credentials for uploads. Multi-tenant: every object key must start with `R2_KEY_PREFIX`. `SMTP_HOST`, `SMTP_PORT`, `SMTP_USERNAME`, `SMTP_PASSWORD`, `EMAIL_FROM` Transactional email credentials. Use `EMAIL_FROM` verbatim for the From header. The agent knows about these and reaches for them automatically when you ask for features that need storage or email: image upload, password reset emails, signup confirmations, and so on. ## [Auth providers (opt-in)# ](#auth-providers-opt-in) Email OTP login is always on. OAuth providers register themselves when both halves of their credential pair are present: Provider Variables Google `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET` Microsoft `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET` GitHub `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET` Add the pair in your project Settings and the login page picks up the new button on the next deploy. No code change required. Microsoft is the one most AV clients will want, since most corporate end users are on Entra ID. ## [Your own variables# ](#your-own-variables) For anything else, a Stripe key, a third-party API token, a feature flag, set the variable in your project Settings. It's mounted into the running app's environment on the next deploy. Removing a variable takes effect on the next deploy as well. Live pods are not patched in place. ## [What not to commit# ](#what-not-to-commit) Never commit secrets to the repo. The platform-injected variables above are read from the environment, not from a checked-in `.env` file, and your own variables should follow the same pattern. \*AVCodex · Your AV expertise. Amplified by AI.\* Was this helpful? [Edit this page →](#) [ Previous Alchemist Local Development ](/docs/guides/alchemist-local-development)[ Next Alchemist Deploys and Domains ](/docs/guides/alchemist-deploys-and-domains) On this page - [Pre-injected variables](#pre-injected-variables) - [Auth providers (opt-in)](#auth-providers-opt-in) - [Your own variables](#your-own-variables) - [What not to commit](#what-not-to-commit) [](/) The AI platform built exclusively for professional AV. Build, deploy, and sell AI tools that understand your industry. ### Platform - What You Can Build - Templates - [Pricing](/pricing) ### Services - [Done-For-You](/pricing) - [Academy](/academy) - [Contact](/contact) ### Company - About - [The Signal](/blog) - [Docs](/docs) - [LinkedIn](#) © 2026 AVCodex. A Future Ready Holdings Inc. product. SOC 2 Type II Certified · HIPAA Compliant