Skip to content

SMTP Configuration for Email Services

SMTP allows the platform to send system emails such as:

  • User registration confirmations
  • Password reset emails
  • Alert notifications

SMTP settings can be configured at the following levels:

  • Controller-level (radm setup) — Default settings for the entire platform i.e. for all orgs/partners
  • Partner-level (Ops Console) – Applies to all organizations under a partner
  • Organization-level (Web Console) – Applies only to one organization

How SMTP Settings Work

  • Controller-level settings act as the default.
  • Partner-level settings override controller-level settings.
  • Organization-level settings apply only to that organization.
  • If no partner or organization settings are configured, the system uses the controller-level settings.

Required SMTP Settings

You must provide the following:

Field Description
Host SMTP server hostname or IP address
Port SMTP server port number
Username SMTP login username
Password SMTP login password
From Email Email address used to send notifications
TLS Enable TLS encryption (recommended)

Controller-Level SMTP Configuration (radm)

Important

  • Most users should configure SMTP in the Ops Console.
  • Controller-level configuration is only for platform administrators.
  • It requires Kubernetes admin access and familiarity with kubectl.

Controller-level SMTP configuration define the default SMTP behavior for the platform.

In radm-managed environments, SMTP values are set as environment variables in the event-framework deployment.

  1. Export the current deployment configuration: 
    kubectl get deployment event-framework -n rafay-system -o yaml > event-framework.yaml
````
2. Edit the exported YAML file and update the SMTP-related environment variables.

3. Apply the updated configuration:
    kubectl apply -f event-framework.yaml 
    4. Restart the deployment to apply the changes:
    kubectl rollout restart deployment event-framework -n rafay-system ```

Notes:

  • Modify only SMTP-related configuration values.
  • Restart is required for configuration changes to take effect.
  • Incorrect SMTP values may prevent email delivery.

Partner-Level SMTP Configuration (Ops Console)

Partner-level SMTP settings apply to all organizations under a partner and override controller-level settings.

  1. Log in to the Ops Console as a partner admin and navigate to SMTP.

  2. Enter the following details:

    • Host: SMTP server hostname or IP address
    • Port: SMTP server port
    • TLS: Enable or disable encryption
    • Username: SMTP authentication username
    • Password: SMTP authentication password

  3. (Optional) Click Send Test Email to verify the configuration.

  4. Click Save to apply the configuration.

Partner SMTP Configuration

Organization-Level SMTP Configuration (Web Console)

Organization-level SMTP settings apply only to the selected organization.

Important: The SMTP Configuration feature may not be available to all organizations by default.

  1. Navigate to Infrastructure → System → Settings.
  2. Under Settings, select SMTP Configuration.

  3. Provide the following details:

    • Host: SMTP server hostname (for example, smtp.gmail.com or smtp.sendgrid.net)
    • Port: SMTP server port (commonly 587 for TLS)
    • TLS: Enable or disable TLS encryption
    • Username: SMTP authentication username
    • Password: SMTP authentication password

  4. (Optional) Click Send Test Email to verify the configuration.

  5. Click Save to apply the configuration.

SMTP Configuration UI