Configure SMTP

Configure SMTP for your Continuous Delivery installation so that users can receive email notifications from the software.

The root user or a super user must do this task.

  1. Log into the root console by signing in as the root user or by selecting Root console from the workspaces menu at the top of the Continuous Delivery navigation bar.
  2. Click Settings > SMTP.
  3. If your SMTP server requires authentication, enter the SMTP username and SMTP password in the relevant fields.
  4. In the Send emails from this address field, enter the sender address you want to show on Continuous Delivery emails.
    If this field is not specified, Continuous Delivery uses the root user's email address as the sender/from address when it sends an email. In this case, the specified SMTP account must have permission to send emails from the root user's email address.
  5. Enter your SMTP host name and the SMTP port number in the relevant fields. Contact your email server administrator if you need help determining the correct SMTP port.
  6. If your server requires TLS authentication, toggle the Enable TLS switch. Only implicit TLS is supported, typically on port 465 or 25.
  7. Click Save settings.
  8. To test your new SMTP configuration, generate a password reset email:
    1. Log out of Continuous Delivery.
    2. On the sign-in screen, click Forgot your password?.
    3. Enter the email address associated with your Continuous Delivery account and click Send reset instructions.
    4. Check your inbox for the password reset email. You can ignore the password reset instructions and keep your current password; this test just ensures Continuous Delivery can send emails.
Results
After configuring SMTP, Continuous Delivery sends these emails:
  • Password reset instructions when requested by a user.
  • Password reset confirmation when a password is updated.
  • Deployment approval request notifications when a deployment to a protected environment is proposed.
What to do next
To remove an unwanted SMTP configuration, you can delete it from the SMTP settings page in the root console.