Configuration

Releval is configured using environment variables or appsettings.json, the standard ASP.NET Core configuration providers. Environment variables use __ (double underscore) as the section separator.

For example, the appsettings.json path Smtp.Host becomes the environment variable Smtp__Host.

Tip

Environment variables take precedence over appsettings.json values, making them ideal for Docker deployments where you don't want to mount configuration files. See configuration provider precedence for the full ordering.

Deployment address

Releval__BaseUrl is the absolute URL used to reach this deployment, for example https://releval.acme.com. Every link Releval sends out in emails and notifications uses this base URL.

Set it. Nothing fails loudly without it, which is what makes it easy to miss:

Set the base URL

It is recommended to set Releval__BaseUrl so that outbound links work correctly.

Variable	Default	Description
Releval__BaseUrl	(none)	The absolute URL members use to reach this deployment, including scheme, port, and no trailing path.

Environment Variable

environment:
  - Releval__BaseUrl=https://${RELEVAL_HOST}

appsettings.json

{
  "Releval": {
    "BaseUrl": "https://${RELEVAL_HOST}"
  }
}

Configuration sections

Section	Description
Data Storage	PostgreSQL, ClickHouse, file storage (local or S3), and Redis
Authentication	OAuth providers, registration, and JWT settings
Email	SMTP server for sending invitation and password reset emails
Notifications	Slack workspace connection and notification delivery settings
Data Protection	Encryption key persistence for cookies and tokens
CORS	Cross-origin request settings
Licensing	License file and resource limits
Logging	Log levels and verbosity