Knowledge base

Sending addresses

VirtualMTAs Display
Who is busy with what right now

Lists sending addresses that currently have mail in the queue, by number of recipients in descending order.

Each address has its own top domains page: the ten receivers with the largest queue for that particular address — recipients, volume, open connections and the last error.

It shows how addresses work, not their settings: an address with an empty queue is not visible here, and the values in force for a pair are printed by the show settings command.

The same response as a structure — /vmtas?format=json; the queues of one address — /queues?format=json&queue=*/address-name.

Access is decided by http-access based on the address the browser is opened from — the monitor level is enough for viewing.

The main trap is looking here for an idle address. An address without mail in the queue is not shown at all, and “the address is not in the list” does not mean “the address is not configured” — it only means it has nothing to send right now.
What the Hub does. It does not use the page: the “vMTAs and jobs” tab of the “PMTA monitoring” screen takes /vmtas?format=json and adds the addresses the Hub created itself — which is why an idle address is visible there, unlike on this page.
Recommended values

What question the page answers:

Question This one or not
which addresses are busy now yes
which receivers one address is stuck on yes — its top domains page
which values apply to a pair no — show settings
all node addresses, including idle ones no
The “only with mail in the queue” filter, the order and the address’s top domains page come from the manual (§ 5.9); the pair settings command is § 6.3.16. The split of questions is ours.
Example configuration
# the same in the console: addresses and the resulting values of one pair
pmta show vmtaspmta show settings gmail.com/vmta1
The second command shows not the load but the values in force for a “receiver and sending address” queue.
yellow — — directive names, blue — blocks. They are highlighted the same way in the text of the card.
Compatibility
PowerMTA 6.0
described in the manual of this version · platform: any
The vendor does not state the first version for every directive — there is no note here. The name also appears in the 5.0 edition of the manual.
How to check on the node
Compare the page with the console:
pmta show vmtas
curl -s 'http://127.0.0.1:8080/vmtas?format=json' | head -40
The command prints all addresses with a queue by default, while the page and its request show the top by http-default-max-items.
In the Hub
Cost of a mistake
safe: a wrong value breaks nothing
Scenarios
Sending address rotation · Address warm-up