--- title: "Configuring the mail server" slug: "configuring-the-mail-server-5" tags: ["Network Security (NX)"] updated: 2026-09-10T17:44:21Z published: 2026-09-10T17:44:21Z canonical: "docs.trellix.com/configuring-the-mail-server-5" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Configuring the mail server Health check event notifications and scheduled reports can use the same mail server. If you use the CLI to configure the server, you must use two separate sets of CLI commands. The mail server settings are described in the following table. ## System mail server settings | Web UI Field | Health Check CLI Parameter | Report CLI Parameter | Description | | --- | --- | --- | --- | | Enable email | — | — | Enables the email delivery of health check notifications and scheduled reports. | | Mail hub | mailhub | server | The hostname or IP address of the mail server. | | Port | mailhub-port | port | The SMTP port used to send the emails. The default is 25. | | Domain | domain | domain | The domain name from which emails will appear to come. The default is the active domain for the appliance. | | Return Addr | return-addr | return-addr | *Health check parameter*: The username or fully qualified return address from which emails are sent. If the string contains the @ character, it is considered fully qualified. Otherwise, it is considered a username, and by default takes the form **@.**. The default username is **do-not-reply**. *Report parameter*: The fully qualified return address from which emails are sent. | | Incl. hostname | return-host | — | Whether the appliance hostname is included in the return address. If it is excluded, the return address takes the form **@**. This setting is ignored if the provided return address is fully qualified. | Prerequisites - Operator or Admin access ## Configuring the mail server using the Web UI Use the **Email Settings** page to configure settings for the mail server. ![All_EmailServer_scap.PNG](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-29486e20-4d52-7b56-d980-17fdd5047189(4).png?sv=2026-02-06&spr=https&st=2026-11-20T07%3A13%3A46Z&se=2026-11-20T08%3A13%3A46Z&sr=c&sp=r&sig=WbRm9IYyiiTxP5TIYIBEEcOpdEFB9YrCEhiJaxX%2FY2Y%3D) To configure the mail server: 1. Click the **Settings** tab. 2. Click **Email** on the sidebar. 3. Specify settings as described in [System mail server settings](/network-and-platform/docs/configuring-the-mail-server-5#system-mail-server-settings) . 4. Click **Update** to save your changes. ## Configuring the mail server for health check notifications using the CLI Use the CLI commands in this topic to configure the mail server that sends health check notifications. See [System mail server settings](/network-and-platform/docs/configuring-the-mail-server-5#system-mail-server-settings) for a description of each parameter. > [!NOTE] > Note > > See [Configuring email recipients using the CLI](/network-and-platform/docs/configuring-email-recipients-using-the-cli) for information about configuring the notification recipients. See [Configuring system event notifications using the CLI](/network-and-platform/docs/configuring-system-event-notifications-using-the-cli-3) for information about configuring the events that trigger notifications. To configure the mail server for system notifications: 1. Go to CLI configuration mode: ```plaintext hostname > enable hostname # configure terminal ``` 2. Specify the hostname or IP address of the mail server: ```plaintext hostname (config) # email mailhub { | } ``` 3. Specify the SMTP port used by the mail server to send notifications: ```plaintext hostname (config) # email mailhub-port ``` 4. Specify the domain name from which emails will appear to come: ```plaintext hostname (config) # email domain ``` 5. Specify the username or fully qualified return address from which emails are sent: ```plaintext hostname (config) # email return-addr { | } ``` 6. (Optional) Include the hostname of the mail server in the return address: ```plaintext hostname (config) # email return-host ``` 7. Verify your changes: ```plaintext hostname (config) # show email ``` 8. Save your changes: ```plaintext hostname (config) # write memory ``` > [!NOTE] > Note > > To remove a configuration or restore a default setting, append `no` to the command. For example, to exclude the hostname in the return address, use the `no email return-host` command, and to restore the default domain name, use the `no email domain` command. ### Examples In this example, the return address is not fully qualified, so the hostname ("hostname") and domain are appended to it. ```plaintext hostname (config) # email mailhub 10.1.0.0 hostname (config) # email domain mail.acme.com hostname (config) # email return-addr admin hostname (config) # show email Mail hub:          10.1.0.0 Mail hub port:     25 Domain override:   mail.acme.com Return address:    admin Include hostname in return address: yes Current reply address: admin@hostname.mail.acme.com ... ``` In this example, the return address is fully qualified, so the hostname and domain are not included. ```plaintext hostname (config) # email mailhub 10.1.0.0 hostname (config) # email domain mail.acme.com hostname (config) # email return-addr notify@acme.com hostname (config) # show email Mail hub:          10.2.0.0 Mail hub port:     25 Domain override:   mail.acme.com Return address:    notify@acme.com Include hostname in return address: yes Current reply address: notify@acme.com ... ``` In this example, all settings are restored to their default values. ```plaintext hostname (config) # show email Mail hub:          10.3.0.0 Mail hub port:     26 Domain override:   mailhost.acme.com Return address:    admin Include hostname in return address: no Current reply address: admin@hostname.mailhost.acme.com ... hostname (config) # no email mailhub hostname (config) # no email mailhub-port hostname (config) # no email return-addr hostname (config) # email return-host hostname (config) # show email Mail hub: Mail hub port:     25 Domain override:   Return address:    do-not-reply Include hostname in return address: yes Current reply address: do-not-reply@hostname.acme.com ... ``` ## Configuring the mail server for scheduled reports using the CLI Use the CLI commands in this topic to configure the mail server that sends scheduled reports. See [System mail server settings](/network-and-platform/docs/configuring-the-mail-server-5#system-mail-server-settings) for a description of each parameter. > [!WARNING] > Important > > If you use the CLI to configure the mail server, the changes will not appear on the **Email Settings** page in the Web UI. > [!NOTE] > Note > > See [Adding and removing scheduled report recipients](/network-and-platform/docs/configuring-email-recipients-using-the-cli#adding_and_removing_scheduled_report_recipients) for information about configuring the report recipients using the CLI. To configure the mail server for scheduled reports: 1. Go to CLI configuration mode: ```plaintext hostname > enable hostname # configure terminal ``` 2. Specify the hostname or IP address of the mail server: ```plaintext hostname (config) report email smtp server { | } ``` 3. Specify the SMTP port used by the mail server to send reports: ```plaintext hostname (config) # report email smtp port ``` 4. Specify the domain name from which emails will appear to come: ```plaintext hostname (config) # report email smtp domain ``` 5. Specify the fully qualified return address from which emails are sent: ```plaintext hostname (config) # report email smtp return-addr ``` 6. Verify your changes: ```plaintext hostname (config) # show report email ``` 7. Save the configuration: ```plaintext hostname (config) # write memory ``` > [!NOTE] > Note > > To remove a configuration or restore the default setting, append `no` to the command. For example, to restore the default return address, use the `no report email return-addr` command, and to remove the configured domain name, use `the no report email smtp domain` command. ### Examples In this example, the email server is configured to send scheduled reports. ```plaintext hostname (config) # report email server 10.4.0.0 hostname (config) # report email smtp domain mailer.acme.com hostname (config) # report email smtp return-addr reports@acme.com hostname (config) # show report email Report email configurations:        SMTP server: 10.4.0.0          SMTP server port: 25        SMTP Domain: mailer.acme.com        SMTP Return addr: reports@acme.com        ... ``` In this example, all configuration settings are restored to their default values. ```plaintext hostname (config) # show report email Report email configurations:        SMTP server: 10.4.0.0        SMTP server port: 26        SMTP Domain: acme.com        SMTP Return addr: admin@acme.com        ... hostname (config) # no email report smtp server hostname (config) # no email report smtp port hostname (config) # no email report smtp domain hostname (config) # no email report smtp return-addr hostname (config) # show report email Report email configurations:        SMTP server:        SMTP server port: 25        SMTP Domain:        SMTP Return addr: do-not-reply        ... ```