postqueue
Manage the Postfix mail queue
TLDR
List mail queue
SYNOPSIS
postqueue [options]
DESCRIPTION
postqueue manages the Postfix mail queue, providing safe access to queue operations for regular users without requiring root privileges. It displays queued messages with their IDs, sizes, arrival times, senders, and recipients, and can trigger delivery retry attempts.
The flush option forces immediate delivery attempts for all deferred mail or for a specific destination site. JSON output mode makes queue data easily parseable for monitoring scripts. For advanced queue management like deleting or holding individual messages, the privileged postsuper command is needed instead.
PARAMETERS
-p
Print queue contents.-f
Flush queue (retry delivery).-s site
Flush specific site.-j
JSON output format.-c dir
Configuration directory.
EXAMPLES
postqueue -p
# Flush all queued mail
postqueue -f
# Retry specific domain
postqueue -s gmail.com
# JSON output for scripting
postqueue -j
# Count queued messages
postqueue -p | tail -1
QUEUE OUTPUT
ABC123DEF 1234 Mon Jan 01 12:00:00 sender@example.com
recipient@dest.com
QUEUE LOCATIONS
/var/spool/postfix/active - Being delivered
/var/spool/postfix/deferred - Temporary failures
/var/spool/postfix/hold - Manually held
CAVEATS
Flushing may not help permanent failures. Use postsuper for advanced queue management.
HISTORY
postqueue is part of Postfix by Wietse Venema, providing safe queue management for unprivileged users.
