PowerMTA v3.7
PowerMTA Directive Index
A searchable operational reference for source, VMTA, destination, queue, DKIM, TLS, authentication, listener, logging, and security controls.
smtp-source-host
Bind an outbound source IP and announce the matching HELO hostname.
Globalhost-name
Set the server identity used where PowerMTA needs its own hostname.
Globalpostmaster
Define the administrative postmaster address used by the MTA.
Managementhttp-access
Restrict access to the PowerMTA web monitor by source network.
Listenersmtp-listener
Create an SMTP listener on a specific address and port.
Listenersource
Apply rules to SMTP clients based on their connecting IP or network.
Authenticationsmtp-user
Create authenticated SMTP credentials and attach user-specific controls.
Relay controlalways-allow-relaying
Permit relaying for a trusted source or authenticated context.
Privacyhide-message-source
Control whether message source information is displayed in management interfaces.
VirtualMTAvirtual-mta
Define an outbound identity with its own source IP, hostname, and policy.
VirtualMTAvirtual-mta-pool
Group multiple virtual MTAs for controlled distribution.
Routingvirtual-mta
Select the virtual MTA used for a source, sender, pattern, or domain policy.
Domainmax-smtp-out
Limit simultaneous outbound SMTP connections for a destination domain.
Domainmax-msg-per-connection
Limit messages delivered over each SMTP connection.
Domainmax-msg-rate
Cap the delivery rate to a destination over a time interval.
Queueretry-after
Set the delay before retrying a temporarily failed delivery.
Queuebounce-after
Set the maximum queue lifetime before a message is expired.
Queuebackoff-retry-after
Set retry timing while a destination is in backoff mode.
Queuebackoff-to-normal-after-delivery
Return a destination to normal mode after a successful delivery.
Patternssmtp-pattern-list
Define reusable SMTP response matching rules.
Domainsmtp-pattern-list
Apply a response pattern list to a domain policy.
DKIMdkim-sign
Enable DKIM signing for messages matching the configured identity.
DKIMdkim-identity
Choose the identity used for DKIM signing.
DKIMdkim-key
Reference the private key and selector used to sign a domain.
TLSuse-starttls
Control whether PowerMTA attempts STARTTLS for outbound delivery.
TLSrequire-starttls
Require TLS for delivery to a destination.
Authenticationallow-unencrypted-plain-auth
Control whether plaintext authentication may occur without TLS.
Logginglog-file
Choose the main PowerMTA log destination.
Loggingaccounting-file
Write accounting records for delivery and bounce analysis.
Securityrun-as-root
Control whether PowerMTA continues running with root privileges.
Storagesync-msg-create
Control synchronous queue-file creation behavior.
Injectionpickup
Configure pickup-directory based message injection.