How To: Use a Mail Relay for Password Reset Emails
==================================================

For security, InterWorx does not send password reset emails through the
typical outbound email relays. In an environment where system administrators
only allow messages from a specific relay or relays, this could mean that password
reset emails may not arrive.  In this rare occasion, it is possible for system administrators to set the 
relay that will be used for sending password reset emails.

.. contents::

To Configure a Mail Relay for Password Reset Emails
----------------------------------------------------

#. Log in to the server at the CLI as root, either via SSH or from
   the terminal
#. At the CLI, using a text editor, open ``~iworx/iworx.ini``. The following example uses the Vim text editor: 

   .. code-block::

      vim ~iworx/iworx.ini

#. In edit mode, add the following to the end of the file:

   .. code-block::

      [lostpass]
      relay="relayserveraddress.tld"

#. Save and exit the file