Configuration
All configuration options for your Fyren instance.
Fyren is configured through environment variables. All variables can be set in a .env file or passed directly to the Docker container.
| Variable | Description | Example |
|---|
DATABASE_URL | PostgreSQL connection string | postgres://user:pass@localhost:5432/fyren |
REDIS_URL | Redis connection string | redis://localhost:6379 |
BASE_URL | Public URL of your Fyren instance | https://status.example.com |
| Variable | Description | Default |
|---|
AUTH_SECRET | Secret key for session signing | (auto-generated) |
AUTH_TRUST_HOST | Trust the X-Forwarded-Host header | false |
| Variable | Description | Default |
|---|
EMAIL_PROVIDER | Email provider: ses, sendgrid, or smtp | smtp |
SMTP_HOST | SMTP server host | — |
SMTP_PORT | SMTP server port | 587 |
SMTP_USER | SMTP username | — |
SMTP_PASS | SMTP password | — |
SMTP_FROM | Default "from" address | [email protected] |
SENDGRID_API_KEY | SendGrid API key (when using SendGrid) | — |
AWS_REGION | AWS region for SES | us-east-1 |
| Variable | Description | Default |
|---|
DEFAULT_CHECK_INTERVAL | Default monitor check interval in seconds | 60 |
DEFAULT_TIMEOUT | Default request timeout in milliseconds | 10000 |
DEFAULT_FAILURE_THRESHOLD | Failures before marking as down | 3 |
| Variable | Description | Default |
|---|
ORG_NAME | Organization name displayed on status page | My Organization |
ORG_LOGO_URL | URL to organization logo | — |
BRAND_COLOR | Primary brand color (hex) | #d4c9b8 |
| Variable | Description | Default |
|---|
PORT | Port to listen on | 3000 |
LOG_LEVEL | Logging level: debug, info, warn, error | info |
CORS_ORIGINS | Allowed CORS origins (comma-separated) | * |
RATE_LIMIT_MAX | Max requests per window for rate limiting | 100 |
RATE_LIMIT_WINDOW | Rate limit window in seconds | 60 |