Email configurations

2 minute readAutomation

Use this page to manage email configurations on the CloudBees CD/RO server. You must create at least one email configuration before you can send email notifications to individuals or groups.

If you have multiple users or groups in remote locations that use a different mail server, create additional email configurations to accommodate those locations if they need to receive CloudBees CD/RO notifications.

Before creating email configurations, make sure your CloudBees CD/RO server settings related to email notification are set appropriately.

Creating email configurations

  1. Enter information into the fields as follows:

    Field Name Description


    Unique name to identify the email configuration


    (Optional) Plain text or HTML description for this object. If using HTML, you must surround your text with <html> …​ </html> tags. Allowable HTML tags are <a>, <b>, <br>, <div>, <dl>, <font>, <i>, <li>, <ol>, <p>, <pre>, <span>, <style>, <table>, <tc>, <td>, <th>, <tr>, and <ul>.

    • For example, the following HTML:

      <p> <span style="font-family: Arial;"> <i>Note:</i> For more information about the <b>abc</b> object, see <a href=""></a>. </span> </p>

      renders as follows:

      <i>Note</i>: For more information about the <b>abc</b> object, see

    Mail protocol

    Specify either SMTPS or SMTP

    Mail host

    Mail server name

    Mail port

    (Optional) Port number for the mail server. For Google gmail configurations use port 587 for SMTP and port 465 for SMTPS.

    If not specified, 25 for SMTP and 465 for SMTPS are used.

    Mail from

    Email address used as the email sender address for CloudBees CD/RO notifications. This must be a fully-qualified email address (meaning that it must be of the form <name>@<domain> )

    Credential type

    Indicates whether the credentials are local or external

    Mail username

    Individual name or a generic name such as qa-test

    Mail password

    Password for the mail user name

  2. Select Save after filling in all fields.

  3. Select Test to make sure your email configuration works:

    Enter a destination email address into the Email Configuration Test popup that opens and select Send.

Editing configurations

Select the configuration name to open the Edit email configuration pane to add or change permissions. You can modify any information or add new information. Select OK after completing your edits.

Deleting configurations

Select the configuration name, then select Delete email configuration or select the Actions button, and then select Delete.

CloudBees CD/RO server settings

Before you create email configurations, make sure your CloudBees CD/RO server settings for email notifications are configured appropriately.

  1. Go to the Edit Server Settings page: from the CloudBees CD/RO main menu, select Server from the Administration column, and then select Settings on the Server page.

  2. Review and set these settings:

    Field Name Description

    Date and time format for email notifications

    Format to use for rendering date and time in email notifications.

    Protocols for SSL connections to the SMTP server

    Whitespace-separated list of protocols that are enabled for SSL connections to the SMTP server. Used to set the mail.smtp.ssl.protocols system property. Defaults to 'TLSv1.2'.

    Set the 'From' header when sending email notifications

    If true, set the From header in the email message. Defaults to true.

  3. Click OK to save the settings.