---
title: "Manage the Exim mail queue in WHM"
description: "In this article I'll show you how you can manage your Exim mail queue on your VPS (Virtual Private Server) or dedicated server in WHM (Web Host Manager). Here you can check for any messages that..."
url: https://www.inmotionhosting.com/support/email/manage-the-exim-mail-queue-in-whm/
date: 2013-01-18
modified: 2021-08-16
author: "InMotion Hosting Contributor"
categories: ["Email", "WebHost Manager (WHM)"]
type: post
lang: en
---

# Manage the Exim mail queue in WHM

In this article I’ll show you how you can manage your Exim mail queue on your VPS (Virtual Private Server) or dedicated server in WHM (Web Host Manager). Here you can check for any messages that might be held up for delivery for a variety of reasons.

Exim is the mail software that runs on your server to control email delivery, there are mail queue management options you can use with Exim directly via the command line. However below we’ll cover how you can use the **Mail Queue Manager** in WHM to simplify the process of tracking down deliveries.

In order to follow along with the steps below you’ll need to have [root access](/support/server/ssh/root-access-faq/) to either your VPS or dedicated server.

## Using the Mail Queue Manager in WHM

For this example, let’s say we’ve emailed **user@example.com**, but they are saying they haven’t received our message yet.

1. [Log into root WHM](/support/edu/whm/log-into-whm/).
2. [![click on mail queue manager in WHM](https://www.inmotionhosting.com/support/wp-content/uploads/2013/01/email_exim_whm-mailqueue_click-on-mail-queue-manager.png)](/support/wp-content/uploads/2013/01/email_exim_whm-mailqueue_click-on-mail-queue-manager.png) In the top left **Find** box, type in **exim**, then click on **Mail Queue Manager**
3. [![fill out email search details then click run report](https://www.inmotionhosting.com/support/wp-content/uploads/2013/01/email_exim_whm-mailqueue_fill-out-search-details-click-run-report.png)](/support/wp-content/uploads/2013/01/email_exim_whm-mailqueue_fill-out-search-details-click-run-report.png) In the **Search…** box type in **user@example.com** From the **Select Query** drop-down, select **Search Recipients** For the **Search Type**, you can leave **Begins With** selected Specify the **Start Date** and **End Date** to search between. You can manually type these in, or click on the calendar icon that displays a 17 Also specify the **Start Time** and **End Time** to search between Finally click on **Run Report**
4. [![click on view message](https://www.inmotionhosting.com/support/wp-content/uploads/2013/01/email_exim_whm-mailqueue_click-on-view-message.png)](/support/wp-content/uploads/2013/01/email_exim_whm-mailqueue_click-on-view-message.png) In this case we can see that our messages to **user@example.com** are **Frozen**. This means that Exim has detected an error trying to deliver the message, and it is going to hold the message and try again later. You can click on the magnifying glass icon to view the message in a new window.
5. [![viewing message in mail queue manager](https://www.inmotionhosting.com/support/wp-content/uploads/2013/01/email_exim_whm-mailqueue_viewing-message-in-mail-queue-manager.png)](/support/wp-content/uploads/2013/01/email_exim_whm-mailqueue_viewing-message-in-mail-queue-manager.png) Reviewing the message we can see that it’s not delivering to **user@example.com** because their mail server is giving us back the error of **Mailbox quota exceeded**.
6. At the top of the message you’re viewing you can choose to **Delete Message** which will completly remove it from the mail queue. Or you can choose to **Deliver Message Now** which will attempt to send the message again, in this case if the user has freed up some space on their email account it should go through successfully now.

You should now understand how you can use the **Mail Queue Mananger** in WHM to manage your Exim mail queue.