How to Reset the Exim Configuration Manager in WHM?

The Exim Configuration Manager in WHM lets you customise how your server handles email through the Exim mail transfer agent (MTA). If you have made extensive changes to your Exim configuration and run into mail delivery issues — or simply want to start fresh — you can reset the configuration to its default state directly from WHM.

Step 1: Log in to WHM

Open your browser and navigate to https://your-server-ip:2087, then log in with your root credentials.

Step 2: Open the Exim Configuration Manager

In the left-hand sidebar, go to Service Configuration » Exim Configuration Manager.

Step 3: Click Reset Configuration

Scroll to the bottom of the page and click the Reset Configuration button. This will open a dialog asking you to choose a reset type.

Step 4: Choose a Reset Type

Select the appropriate reset option for your situation:

• Reset to default — Restores the entire Exim configuration to cPanel and WHM defaults. Use this if you want a completely clean slate.
• Reset to stock — Reverts to the upstream Exim defaults without any cPanel-specific customisations.

Step 5: Confirm and Save

Click Reset to apply the change. WHM will rebuild your Exim configuration and restart the mail service automatically.

Important Notes

• Resetting the Exim configuration will remove all custom settings you have previously configured, including any custom ACLs, routers, or transport settings made in the Advanced Editor.
• Always back up your current configuration before resetting. You can find the configuration files in /etc/exim.conf and /etc/exim.conf.local.
• After a reset, review the Basic Editor settings to reconfigure essential options such as SPF, DKIM, and spam filtering for your environment.
• If your server uses a non-standard server profile, some options in the Exim Configuration Manager may not appear.

Troubleshooting

• Mail not sending after reset: Verify that your server and domain DNS records (MX, SPF, DKIM) are correctly configured. Check the mail logs at /var/log/exim_mainlog for errors.
• Reset button not available: Ensure your WHM version is up to date. Older versions may present the reset option differently. Run /usr/local/cpanel/cpkeyclt to verify your license and update.

For more details, refer to the official cPanel documentation.