Configuration Reference
All Munera configuration is managed through environment variables. For cloud deployments, these are managed in your account settings. For self-hosted deployments, configure them in .env.production.
Core settings
| Variable | Required | Default | Description |
|---|
SECRET_KEY | Required | — | JWT signing key. Generate with openssl rand -hex 32 |
ENCRYPTION_KEY | Required | — | Fernet key for encrypting sensitive database fields. Generate with Python: from cryptography.fernet import Fernet; Fernet.generate_key() |
ENVIRONMENT | Recommended | dev | Set to production to disable API docs and enable security headers |
FRONTEND_URL | Required | — | Your public-facing URL (e.g. https://munera.example.com) |
CORS_ORIGINS | Recommended | * | Comma-separated list of allowed origins |
Database
| Variable | Required | Default | Description |
|---|
DATABASE_URL | Required | — | PostgreSQL async URL: postgresql+asyncpg://user:pass@host:5432/db |
DB_POOL_SIZE | Optional | 20 | Connection pool size |
DB_MAX_OVERFLOW | Optional | 10 | Max overflow connections |
Redis
| Variable | Required | Default | Description |
|---|
REDIS_URL | Required | — | Redis connection URL: redis://:password@host:6379/0 |
CELERY_BROKER_URL | Optional | Same as REDIS_URL | Override for dedicated Celery broker |
AI & machine learning
| Variable | Required | Default | Description |
|---|
OPENAI_API_KEY | Recommended | — | Required for AI task analysis and smart assignment features |
OPENAI_MODEL | Optional | gpt-4 | gpt-4o for faster responses |
AI_FEATURES_ENABLED | Optional | true | Set to false to disable all AI features |
Email (SendGrid)
| Variable | Required | Default | Description |
|---|
SENDGRID_API_KEY | Recommended | — | Required for email notifications and password resets |
FROM_EMAIL | Recommended | — | Verified sender address (e.g. noreply@example.com) |
EMAIL_ENABLED | Optional | true | Set to false to disable email (useful during testing) |
Authentication & sessions
| Variable | Required | Default | Description |
|---|
ACCESS_TOKEN_EXPIRE_MINUTES | Optional | 30 | JWT access token lifetime in minutes |
REFRESH_TOKEN_EXPIRE_DAYS | Optional | 7 | JWT refresh token lifetime in days |
COOKIE_SECURE | Optional | true | Set to false only for local HTTP development |
Monitoring (optional)
| Variable | Required | Default | Description |
|---|
SENTRY_DSN | Optional | — | Sentry DSN for error tracking. Leave blank to disable |
ELASTICSEARCH_URL | Optional | — | Elasticsearch URL for full-text search. Leave blank to disable gracefully |