DocumentationSettings
Email configuration
SMTP server setup for notifications.
Overview
Checkmate needs an SMTP server to send email notifications and team invitations. Configure it once under Settings > Email. The settings build an SMTP transport for NodeMailer.

Set it up
- Open Settings in the sidebar and select the Email tab.
- Enter the server hostname and port.
- Enter the authentication credentials.
- Adjust the TLS options if your server needs it.
- Click Send test email to verify, then Save.
Note
Only Admins and Superadmins can configure SMTP settings.
Connection
| Field | Notes |
|---|---|
| Email host | Hostname or IP address to connect to, e.g. smtp.gmail.com |
| Email port | Port to connect to, e.g. 587 |
| Email connection host | Hostname used in the HELO/EHLO greeting. Defaults to localhost |
Authentication
| Field | Notes |
|---|---|
| Email address | Used for authentication and as the sender address |
| Email user | Username for authentication. Overrides the email address if set |
| Email password | Password for authentication. Once saved, the field shows that it is set. Click Reset to change it |
| Sender name | Optional friendly name shown in the From field, e.g. Checkmate notifications |
TLS and connections
| Field | Notes |
|---|---|
| Use SSL | Encrypt the connection using SSL/TLS. Recommended |
| Force STARTTLS | Require a TLS upgrade and fail if the server does not support it |
| Disable STARTTLS | Do not use TLS even if the server supports it |
| Reject invalid certificates | Reject self-signed or untrusted certificates. Turn this off only for an internal server with its own CA |
| TLS servername | Hostname used for TLS validation when the host is an IP address |
| Enable connection pooling | Reuse existing connections to improve performance |
Warning
Force STARTTLS and Disable STARTTLS are opposites, enabling both leaves the connection unencrypted. If your provider requires TLS on a non-SSL port, use Force STARTTLS and leave Disable STARTTLS off.
For an internal mail server with a private CA, see Custom CA trust.