Configure SMTP email

Before you begin

Create a dedicated SMTP credential with permission to send only from the OpsKnight sender. Verify the sender address or domain, allow outbound traffic from OpsKnight to the relay, and record the host, port, username, password, TLS requirement, and from-address. Do not use a personal mailbox credential.

Open the feature

In OpsKnight, open Settings → Notifications → Providers → SMTP.

Configure OpsKnight

1. Open Settings → Notifications → Providers and choose SMTP.
2. Enter Host, Port, Username, Password, and From email.
3. Enable secure transport when the relay expects implicit TLS. For STARTTLS, use the relay's documented port and policy.
4. Save, enable SMTP, and send a provider test to a controlled mailbox.

What OpsKnight does

OpsKnight encrypts the stored password and uses the configured relay when email routing selects SMTP. A saved configuration does not prove relay acceptance or inbox delivery.

Verify the result

Confirm the message arrived with the expected sender and inspect its authentication results. Then trigger a synthetic incident through the real routing path. If authentication fails, verify the credential, port, TLS mode, egress policy, and relay allowlist. If accepted mail is missing, check suppression, spam, DMARC, and the provider delivery log.

Change or undo it

Rotate by creating a replacement credential, updating OpsKnight, testing it, and only then revoking the old credential. Before disabling SMTP, move affected routes to a tested provider.

Troubleshooting

For authentication failures, verify the credential, port, TLS mode, egress policy, and relay allowlist. If accepted mail is missing, check suppression, spam, DMARC, and the provider delivery log.

Next steps

• Test a notification
• Configure routing
• Inspect delivery