Savannah Cloud

Environment Variables

All configuration values used by Savannah Cloud services and local Docker setup.

The Savannah Cloud stack reads environment settings from a root .env file in local dev and from deployment environment injection in production.

Required variables

VariableRequiredDescription
JWT_SECRETYesSecret for signing JWT tokens
DATABASE_URLAuto via DockerPostgreSQL DSN
REDIS_URLAuto via DockerRedis connection string
RESEND_API_KEYYes for emailResend API key
AT_API_KEYYes for SMSAfrica's Talking API key
AT_USERNAMEYes for SMSAfrica's Talking username
CLERK_SECRET_KEYYes for SSOClerk JWT verification and org identity
CLERK_PUBLISHABLE_KEYYes for SSOFrontend auth setup

Optional variables

VariableDefaultDescription
APP_URLhttps://api.savannahcloud.comBase URL for invites and app links
GITHUB_TOKENnoneGitHub PAT for deployment triggers
GITHUB_WEBHOOK_SECRETnoneHMAC secret for GitHub pushes
R2_ENDPOINTnoneCloudflare R2 endpoint
R2_ACCESS_KEY_IDnoneR2 access key
R2_SECRET_ACCESS_KEYnoneR2 secret key
R2_BUCKETsavannah-cloudR2 bucket name
ENCRYPTION_KEYnoneSecret encryption key for stored values
PDNS_API_URLhttp://pdns:8081PowerDNS API base URL
PDNS_API_KEYnonePowerDNS REST API auth
PAYSTACK_SECRET_KEYnoneBilling integration secret
PAYSTACK_PUBLIC_KEYnoneBilling public key
ML_SERVICE_URLhttp://ml-service:8001threat detection service URL
ACME_EMAILnoneACME registration email
WORKER_COUNT4number of workers
VITE_API_BASE_URLhttp://localhost:8080console API base

Generate a secure JWT secret

# Linux / WSL / macOS
openssl rand -hex 32

# PowerShell
[Convert]::ToBase64String((1..32 | ForEach-Object { Get-Random -Max 256 }))

Example .env

JWT_SECRET=6a8f2c9b1e7d4a3f0c5b8e2d9a6f3c1b4e7d2a5f8c1b4e7d2a5f8c1b4e7d2a5
DATABASE_URL=postgres://user:pass@postgres:5432/savannah?sslmode=disable
REDIS_URL=redis://redis:6379
RESEND_API_KEY=re_123456
AT_API_KEY=atsk_123456
AT_USERNAME=your_at_username
APP_URL=https://api.savannahcloud.com

Never commit live secrets to version control. Use environment injection or a local .env kept outside source control.

On this page