For Linux and Shell scripting.

Qmail qmHandle

Leave a comment

QmHandle is an open source software which allows you to view and manage the qmail queue.

With this program you can:
* Read the qmail queue, like qmail-qread, with color capabilities.
* Print queue statistics, like qmail-qstat, with color capabilities
* View a message in the queue.
* Remove one or more messages from the queue.
* Force qmail to send queued messages immediately.

How to install qmHandle

Download qmHandle from

After downloading, unzip the file
# tar -zxvf qmhandle-1.2.0.tar.gz

Give execution permission;
# chmod +x qmHandle

Check if qmHandle works fine;
# ./qmHandle -s

Copy the script into /bin/
# cp -pf qmHandle /bin/

If qmHandle is not working, you will have to edit the script to set few configuration options.

First set path to qmail que
my ($queue) = ‘/var/qmail/queue/’;

Then set start/stop command for qmail. On Linux, it will be
my ($stopqmail) = ‘/etc/init.d/qmail stop’;
my ($startqmail) = ‘/etc/init.d/qmail start’;

If you have Parallels Plesk control panel installed, I would recommend you to get qmHandle rpm from

Here are the list of available parameters for qmHandle:
-a : try to send queued messages now (qmail must be running)
-l : list message queues
-L : list local message queue
-R : list remote message queue
-s : show some statistics
-mN : display message number N
-dN : delete message number N
-Stext : delete all messages that have/contain text as Subject
-D : delete all messages in the queue (local and remote)
-V : print program version

Additional (optional) parameters:
-c : display colored output
-N : list message numbers only
(to be used either with -l, -L or -R)

That’s all about qmHandle 😉


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s