SMTP configuration

SMTP is the email path TestOps uses for first-administrator bootstrap, user invitations, and password-reset flows. In the current server installation flow, new deployments need working SMTP before the first administrator can complete activation and before invitation-based onboarding will work.

When this page matters

Use this page when you are:

• preparing a new self-hosted TestOps deployment;
• enabling invitation-based user onboarding;
• enabling password resets for local-authentication users.

If your mail server requires the sender address to match the authenticated account, keep the configured From address aligned with the SMTP username.

Minimum configuration

Set the mail host, transport security mode, authentication settings, and sender address for your deployment method.

Until SMTP works end to end, first-admin bootstrap, user invitations, and password-reset emails will not complete successfully.

Example configuration

The example below shows the shape of a typical authenticated SMTP setup. Use your own mail host, account, and secret values rather than the placeholders shown here.

smtp:
  enabled: true
  host: smtp.example.com
  port: 587
  authEnabled: true
  from: [email protected]
  username: [email protected]
  password: <smtp-password>
  startTLSEnabled: true
  startTLSRequired: true
  sslEnabled: true
  sslTrust: smtp.example.com

SMTP_HOST=smtp.example.com
SMTP_PORT=587
[email protected]
SMTP_PASSWORD=<smtp-password>
[email protected]
SMTP_AUTH=true
SMTP_STARTTLS_ENABLE=true
SMTP_STARTTLS_REQUIRED=true
SMTP_SSL_ENABLE=true
SMTP_SSL_TRUST=smtp.example.com

SPRING_MAIL_HOST=smtp.example.com
SPRING_MAIL_PORT=587
[email protected]
SPRING_MAIL_PASSWORD=<smtp-password>
[email protected]
SPRING_MAIL_PROPERTIES_MAIL_SMTP_AUTH=true
SPRING_MAIL_PROPERTIES_MAIL_SMTP_STARTTLS_ENABLE=true
SPRING_MAIL_PROPERTIES_MAIL_SMTP_STARTTLS_REQUIRED=true
SPRING_MAIL_PROPERTIES_MAIL_SMTP_SSL_ENABLE=true
SPRING_MAIL_PROPERTIES_MAIL_SMTP_SSL_TRUST=smtp.example.com

Verify the configuration

After you apply the SMTP settings and restart TestOps:

1. Confirm that the first-administrator invitation or a user invitation can be sent successfully.
2. Confirm that the recipient receives the email.
3. Confirm that password-reset emails work for local-authentication users if that flow is enabled in your deployment.

Troubleshooting

Email is not sent

Check these points first:

• the SMTP host and port are reachable from the TestOps host or cluster;
• the authentication mode matches the SMTP server requirements;
• the sender address is allowed by the SMTP provider;
• the TLS mode matches the provider's expected transport settings.

Email is accepted by the server but never arrives

Check the recipient-side spam, quarantine, or mail-security handling. If your organization rewrites or blocks outbound mail, involve the mail-platform team before treating the issue as an application problem.

Related pages

• Install Allure TestOps for the broader self-hosted bootstrap path.
• Configuration for the rest of the platform setup.
• Local authentication for the sign-in flow that depends on invitation and reset emails.