Hosting Blog

How to install and use the qmHandle utility with Qmail

qmHandle is a utility for managing the Qmail and mail queue operations. By default, it is not installed with Qmail configuration but you can install it to easily manage Qmail and perform the following operations:-

- Checking the number of emails in Qmail.
- Reading the messages in the mail queue.
- Removing messages from the queue using filters like header, subject, ip, etc.

... and many more things can be done with qmHandle!

To install qmHandle use the steps below:-

step 1: Login onto the mail server and download the qmHandle package using the link below:-

cd /usr/local/src/

wget http://kaz.dl.sourceforge.net/project/qmhandle/qmhandle-1.3/qmhandle-1.3.2/qmhandle-1.3.2.tar.gz

step 2: Extract the qmHandle binary using the command below:-

tar -xzf qmhandle-1.3.2.tar.gz

step 3: Move the Qmail binary from its directory to the Qmail binary directory where you've installed it on the server. For example if you installed it under /var/qmail/ follow the steps below:-

cd qmhandle-*/
mv qmHandle /var/qmail/bin/

step 4: Then you can use it as below:-

/var/qmail/bin/qmHandle -s (To check the emails in the queue)

Total messages: 0
Messages with local recipients: 0
Messages with remote recipients: 0
Messages with bounces: 0
Messages in preprocess: 0

To use more options with qmHandle, run the command below and you'll get all the options that you can use with qmHandle.

/var/qmail/bin/qmHandle

That's all.