Tools

How To Configure SMTP over TLS in Kiwi NG

When attempting to configure email actions in Kiwi NG using SMTP over TLS (port 587), the connection may fail if the settings are incomplete, incorrect, or if the server requires STARTTLS. This article provides the correct steps to configure SMTP with TLS in Kiwi NG.

First published date

9/12/2025 9:49 AM

Last published date

9/12/2025 9:49 AM

Overview

Kiwi NG supports sending email notifications through SMTP servers that require encryption. Most modern mail servers (such as Office 365, Gmail, and Exchange) require connections on port 587 with TLS.

If TLS is not properly configured in Kiwi NG, email tests or alerts may fail with “Connection failed” errors.

Product section

Kiwi Syslog Server

Cause

Common reasons for connection failures when using SMTP over TLS:

  • Incorrect SMTP server address or port number (e.g., using port 25 instead of 587).
  • Wrong security type selected (SSL vs TLS).
  • Firewall blocking outbound connections on port 587.
  • Invalid username/password or missing authentication.
  • SMTP server requiring STARTTLS but client configured for SSL.
  • Outdated TLS version not supported by the mail server.

Resolution

  1. Open Kiwi NG Web Console.
    Navigate to: Setup > Actions > Add Action > Email (SMTP).
  2. Configure SMTP Settings.
    SMTP Server: Enter the hostname (e.g., smtp.office365.com).
    Port: Use 587.
    Security: Select TLS.
    Username/Password: Enter valid SMTP credentials.
    Click Apply.
  3. Restart the Kiwi NG Service.
    Restart the service from Windows Services (services.msc).
    Log back into Kiwi NG.
  4. Test the Configuration.
    Go back to the SMTP configuration.
    Click Test to send a test email.
    If successful, you will see a confirmation message.
  5. If the Test Fails:
    Enable debug logging (Setup > Options > Debug > Level: All).
    Re-run the SMTP test and check logs under: C:\ProgramData\SolarWinds\KiwiSyslogService\logs\emails
    Verify firewall and outbound rules allow port 587.
    Confirm that the SMTP server supports TLS and the credentials are correct.