> ## Documentation Index
> Fetch the complete documentation index at: https://thenile.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom SMTP

> Configure custom SMTP servers in Nile Auth

<Steps>
  <Step>
    1. Navigate to **Tenants & Users -> Configuration -> Email templates**.
    2. Enter the name and SMTP settings for your custom server. The format should be `smtp://username:password@emailservice:587`, which would be provided by the email service
    3. Enter an `app_name` and `sender`. These values will be used by the Nile auth to send your emails.

    <Tip>
      Be sure that **`sender`** is a valid email address. Some email services will
      reject emails that do not have a valid sender address.
    </Tip>
  </Step>

  <Step title="Verify configuration">
    Once your SMTP server is configured, you can test the connection to ensure
    that it is working correctly. Select a template and at the bottom, click the
    **Test email sending** button. It will send an email to the email address of
    your developer account.

    <Info>
      Most services require you to configure a test email. Use the email address
      associated with the single sign on account you used when you logged in.
    </Info>
  </Step>

  <Step title="Configure variables">
    You can use variables in your email templates to personalize the content. The following variables are available automatically:

    * **user.email** - the email of the user
    * **user.name** - if set, the name of the user
    * **api\_url** - the URL of your application. This is used to generate links in the email that come back to the server handling Nile auth requests. By default, this is obtained from the headers of the request, but it is possible to hardcode and/or overide it

    Additional variables can be used and will be replaced in the HTML sent using the `${variable}` syntax. For example

    ```html theme={null}
    <div>
      <div>Dear ${user.email}</div>
      <a href="${api_url}"> Reset Your Password </a>
      <div></div>
    </div>
    ```
  </Step>
</Steps>

* [Email Templates](/auth/email/templates)
* [Email Verification](/auth/email/verification)
* [Per-tenant Overrides](/auth/concepts/per-tenantoverrides)