Skip to main content
availability

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.

ProviderDirect connectionNotes
Personal GmailYesRequires an app password and 2-Step Verification
Microsoft 365NoBasic auth retired 30 April 2026. Use an SMTP relay (see Microsoft 365).
Google WorkspaceNoBasic auth retired 1 May 2025. Use an SMTP relay (see Google Workspace).
On-premises Exchange or other SMTP serverYesConfigure 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​

  1. Sign in to the Google account you want the platform to send from, and open https://myaccount.google.com/.
  2. Select Security.
  3. Turn on 2-Step Verification, if it isn't on already, and complete the setup. Google only offers app passwords once it's on.
  4. 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.
  5. Enter a name for the password, for example Invicti SMTP, and click Create.
  6. 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:

SettingValue
SMTP hostsmtp.gmail.com
Port587 (STARTTLS) or 465 (SSL)
UsernameThe full Gmail address
PasswordThe app password you created
From emailThe 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.

On the Email configuration screen of the installer, select Enable email notifications and fill in the fields:

FieldValue
SMTP hostYour SMTP server hostname
Port587 (STARTTLS) or 465 (SSL)
SecuritySTARTTLS for port 587, SSL for port 465
UsernameThe sign-in username for the SMTP server
PasswordThe password or app password
From emailThe sender address
Display nameThe 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:

  1. Open the Control Center at http://localhost:8088/ and select Configuration in the left navigation.
  2. 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.
  3. Click Test connection to check the connection and sign-in. The test doesn't send an email.
  4. Click Save Configuration, then click Save and Restart to confirm.
Services restart when you save

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.

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 on 465. 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

Was this page useful?