ReferenceEnvironment Variables

Environment variables

This is the auto-generated reference. Source of truth: ../hivecfm-core/.env.example and ../hivecfm-hub/.env.example. Regenerated by pnpm run sync and on every CI run.

Secrets must never be committed. The .env.example files carry only keys + comments. Get actual values from 1Password / team lead.

Setting these for the first time? → Secrets & environment walks through creating .env, generating local-only secrets with OpenSSL, and pulling real values from 1Password.

Source

Showing 82 of 82

DefaultComment
coreOtherOauth credentials for Airtable integration
coreALERTSLow CSAT alert threshold (1-5 scale)
coreALERTSAlert email recipients (comma-separated)
hubUngroupedAPI Key for authentication (required) This key is used to authenticate requests to protected endpoints The server will fail to start if this is not set
coreOtherConfigure Azure Active Directory Login
coreOther
coreOther
coreBASICSAPI Secret for running cron jobs. (mandatory) You can use: `openssl rand -hex 32` to generate a secure one
coreDATABASE
hubUngroupedDatabase connection URL (optional). Port must match POSTGRES_PORT when you override it. Default: postgres://postgres:postgres@localhost:5432/test_db?sslmode=disable Format: postgres://username:password@host:port/database?sslmode=disable
coreDisable FeaturesEmail Verification. If you enable Email Verification you have to setup SMTP-Settings, too.
coreBASICSYou can use: `openssl rand -hex 32` to generate one
coreOtherEnterprise License Key
coreGENESYS CLOUDGenesys Cloud OAuth Credentials
coreGENESYS CLOUD
coreGENESYS CLOUDGenesys Cloud region (mypurecloud.com, mypurecloud.ie, mypurecloud.de, etc.)
coreGENESYS CLOUDWebhook signature verification (generate with: openssl rand -hex 32)
coreOtherConfigure Github Login
coreOther
coreOtherConfigure Google Login
coreOther
coreOtherOauth credentials for Google sheet integration
coreOther
coreOther
coreDOCKER PORTSHiveCFM Core port
coreOther
coreOther
coreOtherLingo.dev API key for translation generation
coreBASICSSet the minimum log level(debug, info, warn, error, fatal)
hubUngroupedLogging level (optional) Default: info Valid values: debug, info, warn, error
coreMAIL SETUP
coreMAIL SETUP
hubUngroupedMessage publisher: per-event processing timeout in seconds (optional). Default: 10
hubUngroupedMessage publisher: event channel buffer size (optional). Default: 1024
coreMETABASE
coreMETABASE
coreMETABASEMetabase embedding secret key (generate with: openssl rand -hex 32)
coreMETABASE
coreS3 STORAGE
coreS3 STORAGEMinIO credentials (also used for S3_ACCESS_KEY/SECRET_KEY)
coreBASICS@see: https://next-auth.js.org/configuration/options#nextauth_secret You can use: `openssl rand -hex 32` to generate a secure one
coreBASICSRequired for next-auth. Should be the same as WEBAPP_URL If your pplication uses a custom base path, specify the route to the API endpoint in full, e.g. NEXTAUTH_URL=https://example.com/custom-route/api/auth
coreOtherOauth credentials for Notion Integration
coreOther
coreDisable FeaturesPassword Reset. If you enable Password Reset functionality you have to setup SMTP-Settings, too.
hubUngroupedHTTP server port (optional) Default: 8080
coreDATABASEPostgreSQL password (generate with: openssl rand -hex 16)
coreOtherDisplay privacy policy, imprint and terms of service links in the footer of signup & public pages.
coreOther
coreOtherGoogle reCAPTCHA v3 keys
coreOtherThe below is used for Next Caching (uses In-Memory from Next Cache if not provided)
hubUngrouped
hubUngroupedRiver UI basic auth (optional, used when running River UI via docker compose) Defaults: admin / changeme if unset
coreS3 STORAGES3 configuration - auto-configured for MinIO in docker-compose
coreS3 STORAGE
coreS3 STORAGEFor MinIO (default): http://minio:9000 (internal docker network) For AWS S3: leave empty
coreS3 STORAGEForce path style for S3 compatible storage (0 for disabled, 1 for enabled) Set to 1 for MinIO, 0 for AWS S3
coreS3 STORAGE
coreS3 STORAGE
hubUngroupedGraceful shutdown timeout in seconds (optional). Default: 30
coreOtherOauth credentials for Slack integration
coreOther
coreMAIL SETUP
coreMAIL SETUP
coreMAIL SETUP
coreMAIL SETUPEnable SMTP_SECURE_ENABLED for TLS (port 465)
coreMAIL SETUP
coreOtherStripe Billing Variables
coreOther
coreSUPERSET
coreSUPERSET
coreSUPERSETSuperset secret key (generate with: openssl rand -hex 32)
coreTHROTTLINGMaximum surveys per customer per month
coreTHROTTLINGMinimum hours between surveys for same customer
coreOther
coreTWILIO SMSTwilio Account Credentials
coreTWILIO SMS
coreTWILIO SMSTwilio phone number (E.164 format: +1234567890)
coreOtherUnsplash API Key
coreBASICS
hubUngroupedWebhook max count (optional) Max total webhooks allowed; creation returns 403 Forbidden when limit reached. Default: 500
hubUngroupedWebhook max fan-out per event (optional) Max number of webhook jobs enqueued per event; excess is capped and logged. Default: 500