# Database (Required)
DATABASE_URL="postgresql://postgres:your_password@localhost:5432/simstudio"
# Optional read-replica connection string for offloading heavy read paths
# (logs listing, audit logs, dashboard aggregations). Reads fall back to
# DATABASE_URL when unset.
# DATABASE_REPLICA_URL=""

# Authentication (Required unless DISABLE_AUTH=true)
BETTER_AUTH_SECRET=your_secret_key  # Use `openssl rand -hex 32` to generate, or visit https://www.better-auth.com/docs/installation
BETTER_AUTH_URL=http://localhost:3000

# Authentication Bypass (Optional - for self-hosted deployments behind private networks)
# DISABLE_AUTH=true  # Uncomment to bypass authentication entirely. Creates an anonymous session for all requests.

# Private Database Hosts (Optional - for self-hosted deployments only)
# ALLOW_PRIVATE_DATABASE_HOSTS=true  # Uncomment to let database/connector tools reach private/reserved/loopback hosts (e.g. Docker/K8s service names, localhost). Loosens the SSRF boundary; only enable on a trusted private network.

# NextJS (Required)
NEXT_PUBLIC_APP_URL=http://localhost:3000
# INTERNAL_API_BASE_URL=http://sim-app.default.svc.cluster.local:3000  # Optional: internal URL for server-side /api self-calls; defaults to NEXT_PUBLIC_APP_URL
# TRUSTED_ORIGINS=https://www.example.com,https://app.example.com  # Optional: comma-separated additional public origins to trust for auth (apex+www, alias domains). Merged into Better Auth trustedOrigins.
# AUTH_TRUSTED_PROXIES=10.0.0.0/24,192.0.2.10  # Optional: reverse-proxy IPs/CIDRs in front of the app. Better Auth walks x-forwarded-for right to left, skips these hops, and uses the first untrusted address as the client IP (prevents forwarded-header spoofing). Use your proxies' actual addresses, not broad private ranges that also cover clients.

# Chat (Optional)
# COPILOT_API_KEY=                      # Mint one at https://sim.ai. Without it the Sim Chat block, prompt jobs, and Inbox cannot run
# MSHIP_SYSPROMPT_OVERRIDE=             # Highest-priority instructions for Mothership; honored only when the validated API key owner is enterprise
# NEXT_PUBLIC_CHAT_DISABLED=true        # Hides the Chat module: the workspace lands on your first workflow, and the chats list, scheduled tasks, and editor Chat panel are absent. Chat is shown when unset; `bun run setup` sets this for you if you skip the chat key

# Remote Function sandboxes (Optional)
# Build a dedicated Function base before enabling JavaScript imports, Python, or Shell.
# Copilot/Mothership code tools use a separate shell image. It is selected only
# for those code-tool calls and is never a fallback for Function blocks.
# SANDBOXES_ENABLED=true                 # Enables custom sandboxes for self-hosted workspaces
# NEXT_PUBLIC_SANDBOXES_ENABLED=true     # Shows remote Function languages and custom sandbox settings; set only after the provider/base is ready
#
# E2B (default provider)
# After exporting E2B_API_KEY, build with: bun run apps/sim/scripts/build-function-e2b-template.ts
# SANDBOX_PROVIDER=e2b
# E2B_ENABLED=true
# E2B_API_KEY=
# E2B_FUNCTION_TEMPLATE_ID=<sim-function-template>:<sim-function-build-id> # Copy the exact ref printed by the builder
# E2B_FUNCTION_TEMPLATE_GENERATION=<release-epoch-ms> # Copy the monotonic generation printed by the builder
# MOTHERSHIP_E2B_TEMPLATE_ID=              # Mothership shell template ref, required when Mothership runs code on E2B
#
# Daytona
# Build from an accepted E2B parity manifest with: bun run apps/sim/scripts/build-function-daytona-snapshot.ts --name <name> --parity-manifest <path>
# SANDBOX_PROVIDER=daytona
# DAYTONA_API_KEY=
# DAYTONA_FUNCTION_SNAPSHOT_ID=<snapshot-uuid> # Copy the immutable ID printed by the Daytona builder
# DAYTONA_SHELL_SNAPSHOT_ID=               # Mothership shell snapshot ref, required when Mothership runs code on Daytona

# Security (Required)
ENCRYPTION_KEY=your_encryption_key  # Use `openssl rand -hex 32` to generate, used to encrypt environment variables
INTERNAL_API_SECRET=your_internal_api_secret # Use `openssl rand -hex 32` to generate, used to encrypt internal api routes
API_ENCRYPTION_KEY=your_api_encryption_key # Use `openssl rand -hex 32` to generate, used to encrypt api keys
CRON_SECRET=your_cron_secret # Use `openssl rand -hex 32` to generate. Authenticates the scheduler against the background job endpoints (scheduled workflows, polling triggers, connector syncs)

# Email Provider (Optional)
# Configure one or more providers. Every configured provider stays active and is
# tried in order: Resend → AWS SES → SMTP → Azure Communication Services → Gmail.
# If none are configured, emails are logged to console instead.
#
# Resend
# RESEND_API_KEY=                       # API key from https://resend.com
#
# AWS SES (credentials resolved via the standard AWS provider chain:
# env vars, shared config, ECS/EKS task role, EC2 instance profile, SSO)
# AWS_SES_REGION=us-east-1
#
# SMTP (works with MailHog locally: host=localhost port=1025, no auth)
# SMTP_HOST=smtp.example.com
# SMTP_PORT=587                         # 465 = implicit TLS, 587 = STARTTLS, 25 = plain
# SMTP_USER=                            # Optional — omit for unauthenticated relays
# SMTP_PASS=                            # Optional — omit for unauthenticated relays
# SMTP_SECURE=                          # Set "true" to force TLS on connect; auto-true on port 465
#
# Azure Communication Services
# AZURE_ACS_CONNECTION_STRING=
#
# Gmail API (Google-native — service account with domain-wide delegation for
# the gmail.send scope; the Google Workspace SMTP relay also works via SMTP_HOST)
# GMAIL_CREDENTIALS_JSON=               # Inline service-account JSON with domain-wide delegation
# GMAIL_SENDER=noreply@yourdomain.com   # Workspace user the service account impersonates
#
# Shared sender configuration
# FROM_EMAIL_ADDRESS="Sim <noreply@example.com>"
# EMAIL_DOMAIN=example.com              # Fallback when FROM_EMAIL_ADDRESS is unset

# Local AI Models (Optional)
# OLLAMA_URL=http://localhost:11434  # URL for local Ollama server - uncomment if using local models
# VLLM_BASE_URL=http://localhost:8000    # Base URL for your self-hosted vLLM (OpenAI-compatible)
# VLLM_API_KEY=                          # Optional bearer token if your vLLM instance requires auth
# LITELLM_BASE_URL=http://localhost:4000 # Base URL for your LiteLLM proxy (OpenAI-compatible)
# LITELLM_API_KEY=                       # Optional bearer token if your LiteLLM proxy requires auth
# NEXT_PUBLIC_FORCE_HOSTED=true          # Dev only: treat this instance as hosted Sim (sim-auto pool, platform keys); ignored in production builds
# FIREWORKS_API_KEY=                     # Optional Fireworks AI API key for model listing and inference
# FIREWORKS_API_KEY_1=                   # Optional Fireworks API key for rotation (hosted deployments)
# FIREWORKS_API_KEY_2=                   # Additional Fireworks API key for load balancing
# FIREWORKS_API_KEY_3=                   # Additional Fireworks API key for load balancing
# NEXT_PUBLIC_BEDROCK_DEFAULT_CREDENTIALS=true  # Set when using AWS default credential chain (IAM roles, ECS task roles, IRSA). Hides credential fields in Agent block UI.
# AZURE_OPENAI_ENDPOINT=                        # Azure OpenAI endpoint (hides field in UI when set alongside NEXT_PUBLIC_AZURE_CONFIGURED)
# AZURE_OPENAI_API_KEY=                         # Azure OpenAI API key
# AZURE_OPENAI_API_VERSION=                     # Azure OpenAI API version
# AZURE_ANTHROPIC_ENDPOINT=                     # Azure Anthropic endpoint (AI Foundry)
# AZURE_ANTHROPIC_API_KEY=                      # Azure Anthropic API key
# AZURE_ANTHROPIC_API_VERSION=                  # Azure Anthropic API version (e.g., 2023-06-01)
# NEXT_PUBLIC_AZURE_CONFIGURED=true             # Set when Azure credentials are pre-configured above. Hides endpoint/key/version fields in Agent block UI.
# COHERE_API_KEY=                               # Cohere API key for the Knowledge block reranker (rerank-v4.0-pro/-fast, rerank-v3.5). Alternatively set COHERE_API_KEY_1/2/3 for rotation.
# NEXT_PUBLIC_COHERE_CONFIGURED=true            # Set when COHERE_API_KEY (or rotation keys) are pre-configured above. Hides the Cohere API Key field on the Knowledge block UI.

# Hosted tool API keys (Optional - lets Sim supply the key so users don't have to bring their own).
# Each provider reads `{PREFIX}_COUNT` then `{PREFIX}_1..N`, distributing requests round-robin across the keys.
# HUNTER_API_KEY_COUNT=2                         # Number of Hunter.io keys for hosted Hunter blocks
# HUNTER_API_KEY_1=                              # Hunter.io API key #1
# HUNTER_API_KEY_2=                              # Hunter.io API key #2
# PEOPLEDATALABS_API_KEY_COUNT=2                 # Number of People Data Labs keys for hosted PDL blocks
# PEOPLEDATALABS_API_KEY_1=                      # People Data Labs API key #1
# PEOPLEDATALABS_API_KEY_2=                      # People Data Labs API key #2
# CONTEXT_DEV_API_KEY_COUNT=2                    # Number of Context.dev keys for hosted Context.dev blocks
# CONTEXT_DEV_API_KEY_1=                         # Context.dev API key #1
# CONTEXT_DEV_API_KEY_2=                         # Context.dev API key #2

# PDF OCR provider (Optional - defaults to local; legacy installs infer Mistral from configured credentials)
# OCR_PROVIDER=local                              # One of: local, mistral, azure-mistral

# File Storage (Optional - defaults to local disk; use S3, Azure Blob, or Google Cloud Storage for production)
# STORAGE_PROVIDER=local                          # Optional override: local, s3, azure, or gcs. Unset preserves Azure → S3 → GCS → local precedence
# AWS_REGION=us-east-1                            # Required with S3_BUCKET_NAME to enable S3. Use "auto" for Cloudflare R2
# AWS_ACCESS_KEY_ID=                              # Omit to use the instance/IRSA credential chain
# AWS_SECRET_ACCESS_KEY=                          # Omit to use the instance/IRSA credential chain
# S3_BUCKET_NAME=                                 # General workspace files bucket (required with AWS_REGION to enable S3)
# S3_KB_BUCKET_NAME=                              # Knowledge base documents
# S3_EXECUTION_FILES_BUCKET_NAME=                 # Workflow execution files
# S3_CHAT_BUCKET_NAME=                            # Deployed chat assets
# S3_COPILOT_BUCKET_NAME=                         # Copilot attachments
# S3_PROFILE_PICTURES_BUCKET_NAME=                # User profile pictures
# S3_OG_IMAGES_BUCKET_NAME=                       # OpenGraph preview images (falls back to S3_BUCKET_NAME)
# S3_WORKSPACE_LOGOS_BUCKET_NAME=                 # Workspace logos (falls back to S3_BUCKET_NAME)
# S3_ENDPOINT=                                    # Custom endpoint for S3-compatible storage (Cloudflare R2, MinIO, Backblaze B2). Leave unset for AWS S3
# S3_FORCE_PATH_STYLE=true                        # Required for MinIO/Ceph RGW. Leave unset for AWS S3 and R2

# Instagram OAuth (Optional - Instagram App ID/Secret from Meta App Dashboard > Instagram > API setup with Instagram login)
# INSTAGRAM_CLIENT_ID=
# INSTAGRAM_CLIENT_SECRET=
# Instagram publish file uploads require cloud storage above — S3, Azure Blob, or GCS (Meta must fetch a public HTTPS URL).
# Gmail attachments do not need this.

# TikTok OAuth (Optional - Client Key/Secret from the TikTok for Developers app)
# TIKTOK_CLIENT_ID=
# TIKTOK_CLIENT_SECRET=

# Azure Blob Storage
# AZURE_ACCOUNT_NAME=                             # Azure storage account name
# AZURE_ACCOUNT_KEY=                              # Azure storage account key
# AZURE_CONNECTION_STRING=                        # Alternative to account name/key
# AZURE_STORAGE_CONTAINER_NAME=                   # General workspace files container
# AZURE_STORAGE_KB_CONTAINER_NAME=                # Knowledge base documents
# AZURE_STORAGE_EXECUTION_FILES_CONTAINER_NAME=   # Workflow execution files
# AZURE_STORAGE_CHAT_CONTAINER_NAME=              # Deployed chat assets
# AZURE_STORAGE_COPILOT_CONTAINER_NAME=           # Copilot attachments
# AZURE_STORAGE_PROFILE_PICTURES_CONTAINER_NAME=  # User profile pictures
# AZURE_STORAGE_OG_IMAGES_CONTAINER_NAME=         # OpenGraph preview images (falls back to AZURE_STORAGE_CONTAINER_NAME)
# AZURE_STORAGE_WORKSPACE_LOGOS_CONTAINER_NAME=   # Workspace logos (falls back to AZURE_STORAGE_CONTAINER_NAME)

# Google Cloud Storage
# GCS_PROJECT_ID=                                 # GCP project ID (optional — inferred from credentials/ADC when unset)
# GCS_CREDENTIALS_JSON=                           # Inline service-account JSON. Omit to use Application Default Credentials (Workload Identity, GOOGLE_APPLICATION_CREDENTIALS)
# GCS_BUCKET_NAME=                                # General workspace files bucket (enables GCS; all other buckets fall back to it)
# GCS_KB_BUCKET_NAME=                             # Knowledge base documents
# GCS_EXECUTION_FILES_BUCKET_NAME=                # Workflow execution files
# GCS_CHAT_BUCKET_NAME=                           # Deployed chat assets
# GCS_COPILOT_BUCKET_NAME=                        # Copilot attachments
# GCS_PROFILE_PICTURES_BUCKET_NAME=               # User profile pictures
# GCS_OG_IMAGES_BUCKET_NAME=                      # OpenGraph preview images
# GCS_WORKSPACE_LOGOS_BUCKET_NAME=                # Workspace logos

# Admin API (Optional - for self-hosted GitOps)
# ADMIN_API_KEY=  # Use `openssl rand -hex 32` to generate. Enables admin API for workflow export/import.
                  # Usage: curl -H "x-admin-key: your_key" https://your-instance/api/v1/admin/workspaces

# Enterprise Features (Optional - self-hosted). One switch enables organizations, SSO,
# permission groups, audit logs, whitelabeling, session policies, data retention, data
# drains, forks, and the inbox. Set both — the server value grants access, the
# NEXT_PUBLIC_ value decides what the settings UI shows.
# Docs: https://docs.sim.ai/platform/enterprise/self-hosted
# ENTERPRISE_ENABLED=true
# NEXT_PUBLIC_ENTERPRISE_ENABLED=true

# Per-feature overrides. An explicitly set flag wins over ENTERPRISE_ENABLED, so use these
# to enable one feature on its own or to switch a single feature back off.
# ACCESS_CONTROL_ENABLED= / NEXT_PUBLIC_ACCESS_CONTROL_ENABLED=   # Permission groups
# SSO_ENABLED= / NEXT_PUBLIC_SSO_ENABLED=                         # SAML and OIDC sign-in
# WHITELABELING_ENABLED= / NEXT_PUBLIC_WHITELABELING_ENABLED=     # Custom branding
# AUDIT_LOGS_ENABLED= / NEXT_PUBLIC_AUDIT_LOGS_ENABLED=           # Audit logging
# SESSION_POLICIES_ENABLED= / NEXT_PUBLIC_SESSION_POLICIES_ENABLED=
# DATA_RETENTION_ENABLED= / NEXT_PUBLIC_DATA_RETENTION_ENABLED=   # Runs retention deletion — off by default
# DATA_DRAINS_ENABLED= / NEXT_PUBLIC_DATA_DRAINS_ENABLED=         # Export streams
# FORKING_ENABLED=                                                # Workspace forks
# ORGANIZATIONS_ENABLED= / NEXT_PUBLIC_ORGANIZATIONS_ENABLED=     # Organizations only

# Instance organization (Optional). Most enterprise features read their settings from the
# organization that owns a workspace, so a deployment needs an organization for them to
# apply. Setting a name puts every user in one shared org at signup and makes their
# workspaces org-owned. Leave unset to manage organizations yourself via the Admin API.
# INSTANCE_ORG_NAME=Acme Inc
# INSTANCE_ORG_SLUG=acme-inc                 # Optional — derived from the name when unset
# INSTANCE_ORG_OWNER_EMAIL=admin@acme.com    # Optional — defaults to the first user to sign up

# Limits (Optional - self-hosted). With billing disabled (BILLING_ENABLED unset), no plan
# limits are enforced. Explicitly setting a free-tier variable below opts that specific
# limit back in at the configured value.
# RATE_LIMIT_FREE_SYNC=50               # Sync executions per minute
# RATE_LIMIT_FREE_ASYNC=200             # Async executions per minute
# RATE_LIMIT_FREE_API_ENDPOINT=30       # v1 API endpoint requests per minute
# EXECUTION_TIMEOUT_FREE=300            # Sync execution timeout in seconds
# EXECUTION_TIMEOUT_ASYNC_FREE=5400     # Async execution timeout in seconds
# FREE_TABLES_LIMIT=5                   # Max user tables per workspace
# FREE_TABLE_ROWS_LIMIT=50000           # Max rows per user table
# TABLE_DISPATCH_CONCURRENCY_FREE=20    # Rows one table run executes in parallel on free tier
# TABLE_DISPATCH_CONCURRENCY_PAID=50    # Rows one table run executes in parallel on paid tiers (billing disabled uses this)
# FREE_STORAGE_LIMIT_GB=5               # File storage quota in GB