SMTP Configuration

Each tenant can have its own SMTP configuration for sending email notifications, password reset messages, and other system emails. This allows different tenants to use different mail servers and sender identities.

Accessing SMTP Settings

1. Navigate to Tenants and select the tenant.
2. Open the SMTP Settings tab.

Configuration Fields

Field	Description	Example
SMTP Host	Mail server hostname or IP address	smtp.example.com
SMTP Port	Port number for the SMTP connection	587 (STARTTLS), 465 (SSL), 25 (unencrypted)
Use SSL	Enable SSL/TLS encryption for the connection	true for ports 465 and 587
Username	Authentication username (optional if server allows anonymous relay)	notifications@example.com
Password	Authentication password	(secret)
From Address	Sender email address shown in outgoing messages	noreply@example.com
From Name	Sender display name shown in outgoing messages	RAMP Notifications

Setting Up SMTP

1. Enter the SMTP server hostname and port.
2. Enable Use SSL if your mail server requires encrypted connections (recommended).
3. Enter the authentication credentials if required by the server.
4. Set the From Address and From Name that will appear on outgoing emails.
5. Click Test to send a test email.
6. Review the test result. If the test email arrives successfully, click Save.

Testing the Configuration

The Test button sends a test email to verify that the SMTP configuration is working correctly. When you click Test:

1. RAMP establishes a connection to the specified SMTP server.
2. Authenticates with the provided credentials (if configured).
3. Sends a test email from the configured From Address.
4. Reports the result — success or failure with an error message.

Tip

If the test fails, check the following:

• The SMTP host is reachable from the RAMP server (check firewall rules and DNS).
• The port number matches the server’s expected protocol (587 for STARTTLS, 465 for implicit SSL).
• The username and password are correct.
• The From Address is allowed by the mail server’s sending policies.

Common SMTP Configurations

Microsoft 365 / Exchange Online

Setting	Value
Host	smtp.office365.com
Port	587
Use SSL	true
Username	Your Microsoft 365 email address
Password	App password or service account password

Gmail / Google Workspace

Setting	Value
Host	smtp.gmail.com
Port	587
Use SSL	true
Username	Your Gmail address
Password	App-specific password

Note

Google requires app-specific passwords when using SMTP. Regular account passwords will not work if 2-step verification is enabled.

Internal Relay Server

Setting	Value
Host	mail-relay.internal.example.com
Port	25
Use SSL	false
Username	(leave empty)
Password	(leave empty)

Caution

Using port 25 without SSL is acceptable only for internal relay servers that are not exposed to the internet. For any external connections, always use SSL/TLS.

Email Use Cases

RAMP sends emails for the following purposes when SMTP is configured:

• Password reset — when a RAMP Internal user requests a password reset
• Notifications — instance status changes, escalations, and system alerts for users with notification roles
• Pre-escalation warnings — alerts sent before escalation deadlines
• Escalation alerts — urgent notifications when escalation thresholds are exceeded

Note

If SMTP is not configured for a tenant, email-dependent features (password reset, email notifications) will be unavailable for that tenant. Users will still be able to log in and work within RAMP.

Next Steps

With SMTP configured, email notifications will work for the tenant. Continue to manage users and groups to set up the tenant’s user base.

Related topics

Tenant Settings Configure tenant name, slug, domain, status, and general preferences

Email & SMTP Setup System-level SMTP configuration for the RAMP installation