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

# Webuzo

> Configuring a smarthost for Webuzo

This guide will walk you through the process of setting up JetEmail as a smarthost in Webuzo. By integrating JetEmail's advanced features, you'll enhance your email performance, improve deliverability, and benefit from robust security and streamlined email management.

### Setting up Webuzo

<Steps>
  <Step title="Access Exim Configuration">
    1. Log in to Webuzo Admin Panel
    2. Navigate to Email > Mail Settings
    3. Select the "custom code" option from the Exim Configuration Manager
  </Step>

  <Step title="Edit Authenticators Configuration">
    Add the following code to the authenticators section:

    ```plaintext theme={null}
    jetemail_login:
      driver = plaintext
      public_name = LOGIN
      # specify your JetEmail SMTP username and password below
      client_send = : Your_JetEmail_Username : Your_JetEmail_Password
    ```

    Replace `Your_JetEmail_Username` and `Your_JetEmail_Password` with your actual JetEmail SMTP user credentials.
  </Step>

  <Step title="Edit Routers Configuration">
    Add the following code to the routers section:

    ```plaintext theme={null}
    send_via_jetemail:
      driver = manualroute
      domains = ! +local_domains
      ignore_target_hosts = 127.0.0.0/8
      transport = jetemail_smtp
      route_list = * relay.jetsmtp.net::25 randomize byname
      no_more
    ```
  </Step>

  <Step title="Edit Transport Configuration">
    Add the following code to the transport section:

    ```plaintext theme={null}
    jetemail_smtp:
      driver = smtp
      hosts_require_auth = *
      tls_tempfail_tryclear = true
      headers_add = X-AuthUser: $authenticated_id
      hosts_try_chunking =
      hosts_try_fastopen =
      dkim_domain = ${lc:${domain:$h_from:}}
      dkim_selector = default
      dkim_private_key = /var/webuzo-data/mail/dkim/private/${perl{untaint}{${dkim_domain}}}
    ```

    <Warning>
      **DKIM Selector Note**: If your Webuzo installation was completed prior to February 3, 2025, change `dkim_selector = default` to `dkim_selector = x` in the configuration above.
    </Warning>
  </Step>

  <Step title="Restart Services">
    After making these changes:

    1. Save all configuration files
    2. Restart the Exim service
  </Step>

  <Step title="Test Configuration">
    Send a test email to ensure the new configuration is working correctly.
  </Step>
</Steps>

### Troubleshooting

If you encounter any issues:

1. Double-check your SMTP credentials
2. Verify that port 25 is open in your firewall
3. Check the Exim logs for any error messages
4. Ensure your account is active and in good standing

For further assistance, contact support.