mailserver-admin Configuration Reference
Environment variables for the mailserver-admin (web) application. Set in .env or the environment.
General
| Variable | Default | Description |
|---|---|---|
APP_ENV |
prod |
Application environment |
APP_SECRET |
(random) | Secret key (e.g. CSRF) |
CSRF_ENABLED |
true |
Enable CSRF protection |
TRUSTED_PROXIES |
— | Comma-separated trusted proxy IPs |
Database
| Variable | Description |
|---|---|
DB_USER |
Database user |
DB_PASSWORD |
Database password |
DB_HOST |
Database host |
DB_NAME |
Database name |
REDIS_HOST |
Redis host |
REDIS_PORT |
Redis port |
REDIS_PASSWORD |
Redis password |
OAuth2
| Variable | Default | Description |
|---|---|---|
OAUTH_ENABLED |
false |
Enable OAuth2 login |
OAUTH_CLIENT_ID |
— | OAuth2 client ID |
OAUTH_CLIENT_SECRET |
— | OAuth2 client secret |
OAUTH_CLIENT_SCOPES |
"openid email profile groups" |
Requested scopes |
OAUTH_AUTHORIZATION_URL |
— | Authorization URL |
OAUTH_ACCESS_TOKEN_URL |
— | Token URL |
OAUTH_INFOS_URL |
— | Userinfo URL |
OAUTH_ADMIN_GROUP |
admin |
Group name for admin rights |
OAUTH_BUTTON_TEXT |
"Login with OIDC" |
Login button label |
OAUTH_PATHS_IDENTIFIER |
email |
Field containing user identifier (e.g. email) |
OAUTH_CREATE_USER |
false |
Create user if no match |
For setting up OAuth2, see How to configure OAuth2.
MCP server
The MCP_* variables and their defaults are listed in the environment variables reference.