postsuper(1)
Postfix superintendent utility for managing the queue and configuration.
Synopsis
postsuper [-i queue_id] [-p] [-d queue_id] [-h queue_id] [-r queue_id] [-s site_name] [directory]Description
postsuper is the Postfix queue management and administration tool. It allows administrators to delete, hold, or requeue messages in the mail queue, and perform other queue maintenance operations. postsuper requires superuser privileges.
The command operates on Postfix queue directories (usually /var/spool/postfix/deferred, incoming, and active). Queue IDs are unique message identifiers that identify messages waiting for delivery.
postsuper can also be used to compress and update the queue database after manual modifications or system maintenance.
Common options
| Flag | What it does |
|---|---|
-d queue_id | Delete one or more messages from the queue by queue ID or pattern |
-h queue_id | Put one or more messages on hold; they won't be processed until released |
-r queue_id | Requeue one or more messages; move them back to the incoming queue |
-i queue_id | Inspect and display details of a queued message |
-p | Purge the queue: delete all messages from the queue directory |
-s site_name | Rename site in queue entries (migration/renaming utility) |
-c config_dir | Read configuration from the specified directory instead of default |
-v | Enable verbose output; show actions being performed |
Examples
Delete all messages from the queue; use with caution
postsuper -d ALLPut the message with ID 3A12F2A435E on hold to prevent delivery
postsuper -h 3A12F2A435ERequeue the message 3A12F2A435E; it will be processed again
postsuper -r 3A12F2A435EDelete all messages in the deferred queue only
postsuper -d ALL deferredDisplay detailed information about queued message 3A12F2A435E
postsuper -i 3A12F2A435ERequeue multiple messages whose IDs are listed in qids.txt, one per line
postsuper -r - < /tmp/qids.txtDelete all messages starting with 3A12F prefix with verbose output
postsuper -d 3A12F* -vPurge only the hold queue directory
postsuper -p /var/spool/postfix/hold