Deployment: Invicti Platform on-premises (Windows installer and Helm)
Configure SMTP for email notifications
Invicti Platform on-premises needs an SMTP server to send scan alerts, user invitations, and password reset emails. Without it, users can't use Forgot password, can't receive invitations, and don't get scan alerts. This document explains which providers work directly, what to do if your provider requires OAuth, and how to enter the settings in the Windows installer or in your Helm values.yaml file.
Provider compatibility
The platform signs in with a username and password only. It doesn't support OAuth. For providers that require OAuth, you can place an SMTP relay between the platform and the provider — for example, an on-premises Exchange server that accepts basic auth and forwards mail to the cloud provider. Because the platform only needs a standard SMTP server to connect to, a relay that accepts username and password sign-in should work. Configuring and supporting the relay itself is your responsibility.
| Provider | Direct connection | Notes |
|---|---|---|
| Personal Gmail | Yes | Requires an app password and 2-Step Verification |
| Microsoft 365 | No | Basic auth retired 30 April 2026. Use an SMTP relay (see Microsoft 365). |
| Google Workspace | No | Basic auth retired 1 May 2025. Use an SMTP relay (see Google Workspace). |
| On-premises Exchange or other SMTP server | Yes | Configure with the server's host and credentials |
What you need
- An SMTP server or mailbox the platform can send from. A dedicated address, for example
invicti-noreply@example.com, is easier to manage than a personal one. - For personal Gmail: 2-Step Verification turned on for that account. Google only offers app passwords once it's on.
- Network access from the platform to the SMTP server on the port you use. For the full list of required addresses, refer to the Trustlist requirements for Invicti Platform on-premises document.
Personal Gmail
Gmail accepts username and password sign-in with an app password, so you can connect the platform to it directly. The platform signs in with the app password, not your normal Gmail password.
Create an app password
- Sign in to the Google account you want the platform to send from, and open https://myaccount.google.com/.
- Select Security.
- Turn on 2-Step Verification, if it isn't on already, and complete the setup. Google only offers app passwords once it's on.
- Open https://myaccount.google.com/apppasswords. You can also find App passwords under How you sign in to Google in the Security section. Google may ask you to sign in again.
- Enter a name for the password, for example
Invicti SMTP, and click Create. - Copy the 16-character password. Google shows it once only. If you lose it, revoke it and create a new one.
For more information, refer to the Google help page on signing in with app passwords.
Gmail values
Use these values when you enter the settings in Invicti Platform:
| Setting | Value |
|---|---|
| SMTP host | smtp.gmail.com |
| Port | 587 (STARTTLS) or 465 (SSL) |
| Username | The full Gmail address |
| Password | The app password you created |
| From email | The same Gmail address |
Microsoft 365
Microsoft 365 retired basic authentication for SMTP AUTH on 30 April 2026. Direct connections using a username and password are rejected with:
550 5.7.30 Basic authentication is not supported for Client Submission.
To use Microsoft 365 for platform email, you can route through an SMTP relay that accepts basic auth — for example, an on-premises Exchange server. Point the platform to the relay, and configure the relay to forward to Microsoft 365. Set up the relay according to Microsoft's documentation. It's your responsibility to configure and maintain it.
Google Workspace
Google Workspace stopped accepting username and password for SMTP on 1 May 2025. The same workaround applies: you can use an SMTP relay between the platform and Google Workspace. It's your responsibility to configure and maintain the relay.
Personal Gmail accounts with an app password are not affected by this change.
Enter the settings in Invicti Platform
How you enter the settings depends on how you installed the platform.
- Windows installer
- Helm
On the Email configuration screen of the installer, select Enable email notifications and fill in the fields:
| Field | Value |
|---|---|
| SMTP host | Your SMTP server hostname |
| Port | 587 (STARTTLS) or 465 (SSL) |
| Security | STARTTLS for port 587, SSL for port 465 |
| Username | The sign-in username for the SMTP server |
| Password | The password or app password |
| From email | The sender address |
| Display name | The name shown on outgoing email, for example Invicti Platform |
The Security drop-down offers three options: SSL (encrypted from the start, port 465), STARTTLS (upgrades to encryption after connecting, port 587), and Plain (no encryption). Don't use Plain: most mail servers reject sign-in over an unencrypted connection. When you change the security option, the port field updates automatically.
You can also change the SMTP settings after installation in the Invicti Platform Control Center:
- Open the Control Center at
http://localhost:8088/and select Configuration in the left navigation. - In the SMTP card, select Send email through an SMTP server and edit the settings: Host, Security, Port, Sender address, Display name, Username, and Password.
- Click Test connection to check the connection and sign-in. The test doesn't send an email.
- Click Save Configuration, then click Save and Restart to confirm.
Saving redeploys the platform and restarts its services one at a time. Some functions can be briefly unavailable for several minutes. If the platform rejects the new settings, it rolls back to the previous ones automatically.
For more information about the Control Center, refer to the Install Invicti Platform on Windows document.
Add the SMTP settings to your values.yaml file:
global:
smtp:
engine: "smtp"
host: "your-smtp-server.example.com"
port: 587
mail: "invicti-noreply@example.com" # Sender address
displayname: "Invicti Platform"
username: "smtp-username"
password: "smtp-password"
security: "tls" # STARTTLS on port 587
Set security to match the port:
| Value | Connection | Typical port |
|---|---|---|
tls | Starts unencrypted, then upgrades with STARTTLS | 587 |
ssl | Encrypted from the start | 465 |
non-ssl | No encryption | 25 |
Don't use non-ssl: most mail servers reject sign-in over an unencrypted connection. A value that doesn't match the port, such as ssl on port 587, makes the connection fail.
Apply the change with the helm upgrade command. For more information, refer to the Install Invicti Platform using Helm document.
Troubleshooting
Invicti Platform doesn't send email and no error appears
Check these in order:
- The password is correct and wasn't entered with extra spaces. App passwords are shown once, so create a new one if you're not sure.
- The username is correct and in the format your SMTP server expects (usually a full email address).
- The platform can reach the SMTP host on the port you set. Firewalls often block outbound port 587.
- The connection security matches the port: STARTTLS (TLS) on
587, SSL on465. A mismatch makes the connection hang or drop.
The log shows "[SSL: WRONG_VERSION_NUMBER]"
The connection security is set to SSL, but the port is 587. Port 587 expects STARTTLS. In the Windows installer, select STARTTLS in the Security drop-down. In Helm, set security: "tls" in your values.yaml file. Then rerun the installer or run helm upgrade.
Microsoft 365 returns "550 5.7.30 Basic authentication is not supported"
Microsoft 365 retired basic authentication for SMTP AUTH on 30 April 2026. Direct connections from Invicti Platform using a username and password are no longer accepted. To use Microsoft 365 for platform email, you can route through an SMTP relay — for example, an on-premises Exchange server — that accepts basic auth and forwards to Microsoft 365.
The app password option is missing in Gmail
App passwords are only available when 2-Step Verification is turned on for the account. If it's on and the option is still missing, your administrator may have turned app passwords off.
I need to change the SMTP settings after installation
On Windows, open the Control Center, select Configuration, edit the SMTP card, and save. For the steps, refer to the Windows installer tab in this document. With Helm, edit values.yaml and run helm upgrade.
Need help?
Invicti Support team is ready to provide you with technical help. Go to Help Center