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

# Zimbra

The following is our preferred method for configuring Zimbra to work with Abusix Guardian Mail:

Use the `zmprov` command as the `zimbra` user.

1. Switch to the `zimbra` user:\
   `su - zimbra`
2. Add the DNSBL (reject lists) to the global configuration:\
   `zmprov mcf +zimbraMtaRestriction "reject_rbl_client <APIKEY>.combined.mail.abusix.zone"`\
   (Replace \<APIKEY> with “**Your API key”** from your account in [app.abusix.com](http://app.abusix.com).)
3. Next create the file `opt/zimbra/conf/dnsbl-reply-map` if it doesn't already exist add the following:\
   `<APIKEY>.combined.mail.abusix.zone                mail.abusix.zone`
   Replace \<APIKEY> with “**Your API key”** from your account in [app.abusix.com](http://app.abusix.com).  This is important to prevent your API key from leaking.
4. Run `postmap /opt/zimbra/conf/dnsbl-reply-map`
5. Add the following line (as root) to `/opt/zimbra/common/conf/main.cf`\
   `rbl_reply_maps = lmdb:/opt/zimbra/conf/dnsbl-reply-map`
6. Refresh the MTA configuration:\
   `zmmtactl restart`

## Reporting spam back to us

You can also configuring Zimbra to send us spam reports for false-negatives by creating a Data Channel by following the instructions here: [https://docs.abusix.com/docs/abuse-reporting/global-reporting/abusix-global-feedback-loop](https://docs.abusix.com/docs/abuse-reporting/global-reporting/abusix-global-feedback-loop)\
\
Once complete, this will provide you with a \<data-channel-id>@smtp-forward.abusix.com address which you configure Zimbra to send users spam reports to us by completing the following steps:

1. Switch to the `zimbra` user:\
   `su - zimbra`
2. Run `zmprov mcf +zimbraSpamIsSpamAccount <data-channel-id>@smtp-forward.abusix.com`\
   (Replace \<data-channel-id> with the actual address we provided to you)
3. Run `zmcontrol restart`