Configuring the mail server

1. Overview

You can configure the registry communication channels using the Control Plane admin console when creating or editing a registry.

The Platform supports one of the following mail server options, depending on the registry requirements:

  • Internal mail server (platform-mail-server) is a mail server distributed as part of the Platform. This service is available to all registries within a single instance of the Platform.

  • External mail server (external-mail-server) is a mail server outside the Platform (such as Gmail).

Mail server settings are stored in the registry’s values.yaml configuration file as shown in the following examples:

External server:
  global:
    notifications:
      email:
        type: external
        host: smtp.gmail.com
        port: 587
        address: registry@gmail.com
        password: 123
Internal server:
 global:
   notifications:
     email:
       type: internal

2. Configuring an SMTP connection to an external mail server

To connect your registry to an external mail server, perform the following steps.

  1. Sign in to the Control Plane admin console.

    update cluster mgmt 01

  2. Open the Registries section.

  3. Find your registry and click its name to open its settings.

    update registry components 1

  4. Click the Edit button in the upper-right corner.

    update registry components 2

  5. Select the Edit SMTP settings checkbox.

    config smtp server 01

  6. From the Mail server dropdown list, select External mail server.

    config smtp server 02

  7. Specify the following mail server parameters:

    • Host

    • Port

    • Email address

    • Password

    config smtp server 03

  8. Click Confirm to save your settings.

Moving forward, all messages will be sent from the external email address you specified.

3. Configuring an SMTP connection to an internal mail server

To configure your registry to use an internal mail server, perform the following steps.

  1. Sign in to the Control Plane admin console.

    update cluster mgmt 01

  2. Відкрийте меню Реєстри.

  3. Open the Registries section.

  4. Find your registry and click its name to open its settings.

    update registry components 1

  5. Click the Edit button in the upper-right corner.

    update registry components 2

  6. Select the Edit SMTP settings checkbox.

    config smtp server 01

  7. From the Mail server dropdown list, select Platform mail server.

    config smtp server 04

  8. Click Confirm to save your settings.

    config smtp server 05

    The Registry email address field is not editable and only displays the template for the email address.

Moving forward, all messages will be sent from the Platform’s email address.

  • <registry_name>@<registry.platform-domain>

    Where:

    • <registry_name> is the name of your registry.

    • <registry.platform-domain> is the cluster domain name.

An internal SMTP server is configured by the Platform administrator. For details, see Configuring internal SMTP server