.. _SMTP-server:

Add a SMTP Server
-------------------

.. 19.3.1|VOSS-577:


This procedure adds a SMTP server at a hierarchy level. 


**Prerequisites**:

* Enable email in the Global Settings (Email tab). 


**Perform these steps**:

1. Log in to the Admin Portal. 
2. Choose the relevant hierarchy. 

   .. note:: 
      
      Configure the SMTP server at the hierarchy where you want to allow VOSS Automate to 
      send email messages. 
      
      You may only set up one SMTP server at each hierarchy level. The SMTP server 
      will be available at the current hierarchy and below. For example, 
      for a SMTP set up at a specific customer, the sites below that customer can 
      use that SMTP server. 

3. Go to (default menus) **Apps Management > SMTP Server**. 
4. Click the toolbar Plus sign (+) to add a new SMTP server. 
5. On the **SMTP Server** form, fill out details for the new SMTP server in the form fields: 

   ===================== =============================================================================
   Field                 Description 

   Name                  The SMTP server name. 

   Description           A description for the email account. 

   Port                  The port number. 

   Secure                Relevant only for SSL connections to the SMTP server. 
   
                         Select the checkbox (enable) to 
                         use the SSL protocol for connections to the SMTP 
                         server. 

                         Default is disabled (checkbox is left clear), for TLS and unsecure 
                         logins to the SMTP server. 

   Username              The username credential for establishing a connection to the SMTP server. 

   Password              The password credential for establishing a connection to the SMTP server. 
   ===================== =============================================================================


6. Save your changes.  




.. rubric:: Related Topics

* 
  .. raw:: latex

     Email in the Core Feature Guide

  .. raw:: html
  
     <a href="concepts-email.html">Email</a> 

* 
  .. raw:: latex

     Global Settings in the Core Feature Guide

  .. raw:: html
  
     <a href="concepts-global-settings.html">Global Settings</a>