Skip to content

Exim

Using MailMum with Exim is pretty straightforward. You can use MailMum with Exim through RBL (Real-time Blackhole List) technology.

Step 1: Add MailMum as RBL Client to Exim

Exim can be configured using a single configuration file or splitted into multiple files. First we will describe how to add MailMum to acl_check_rcpt in a single configuration file. After that, we will describe how to add MailMum to acl_check_rcpt in split configuration files.

Single Configuration File

To use MailMum with Exim using single configuration file, you need to add MailMum as an RBL client to Exim. This is done by adding the following configuration to the Exim configuration file:

Check your exim configuration file, usually located at /etc/exim/exim.conf.

acl_check_rcpt:
  deny
    dnslists = <uuid>.in.mailmum.io
    message = MailMum: $sender_host_address is listed in MailMum.
    log_message = MailMum: $sender_host_address is listed in MailMum.
    add_header = X-Warning: $sender_host_address is listed by MailMum.

Note: Replace <uuid> with your MailMum UUID. You can find your UUID in the MailMum Dashboard. Don't publish your UUID. It should be kept secret to prevent abuse.

Optional: You can customize the message and log message to your liking. We recommend adding some information regardin the MailMum System to the message. The sender should know why the email was rejected and where he can get more information.

Split Configuration Files

If you are using split configuration files, you need to add the following configuration to the Exim configuration file /etc/exim4/conf.d/acl/30_exim4-config_check_rcpt. Locate the section where ACLs for acl_check_rcpt are defined, and insert your RBL checks. Add the following block within the acl_check_rcpt section:

deny
  dnslists = <uuid>.in.mailmum.io
  message = MailMum: $sender_host_address is listed in MailMum.
  log_message = MailMum: $sender_host_address is listed in MailMum.
  add_header = X-Warning: $sender_host_address is listed by MailMum.

Note: Replace <uuid> with your MailMum UUID. You can find your UUID in the MailMum Dashboard. Don't publish your UUID. It should be kept secret to prevent abuse.

Optional: You can customize the message and log message to your liking. We recommend adding some information regardin the MailMum System to the message. The sender should know why the email was rejected and where he can get more information.

Step 2: Check the Exim Configuration

After adding the configuration, you need to test the Exim configuration. This is done by running the following command:

sudo exim -bV

If the configuration is incorrect, you should check whether the UUID in the configuration is correct. If you can't fix it yourself, please contact the MailMum support for help.

Step 3: Reload Exim

After adding the configuration, you need to reload Exim to apply the changes. This is done by running the following command:

sudo exim reload

If you are using SystemV, you can use the following command:

sudo service exim reload

If you are using systemd, you can use the following command:

sudo systemctl reload exim

Step 4: Test the Setup

To test the configuration, you can send an email to your server from an email address using an external E-Mail Service like Google Mail or Outlook.com.

If the setup was successful, the email should be delivered by Exim and you should see an entry in the MailMum Dashboard.

Note: If you don't have any block entries in the MailMum System, MailMum behaves like a monitoring system. It only logs the requests from your Exim server and enhance them with additional information.