PowerMTA

PowerMTA 5.0 Features and Upgrade Guide (2026)

A practical walkthrough of PowerMTA 5.0's HTTP APIs, redesigned web monitor, and upgrade steps from 4.5, including rollback checks.

By Shane3 views
PowerMTA 5.0 Features and Upgrade Guide (2026)

PowerMTA 5.0 features represent a shift towards API-first operations and better visibility for senders who manage their own infrastructure. If you are still running 4.5, a blind upgrade can result in failed HTTP endpoints, broken monitoring, and silent configuration incompatibilities that only surface when queues stall. This guide is a practical walkthrough, not a sales sheet.

By the time you finish, you will understand what changed in the 2026 release, how to use the new HTTP submission APIs and webhooks, what the redesigned Web Monitor gives you, and how to perform a controlled upgrade from 4.5 to 5.0 with a rollback plan. You will also learn which compatibility checks matter before you restart the service.

What’s New in PowerMTA 5.0

PowerMTA 5.0 concentrates on operational visibility and integration flexibility. The two headline changes are the addition of HTTP-based transmission APIs and a rebuilt Web Monitor. Under the hood, queue management and routing flexibility have been tightened, but the external impact is a more scriptable MTA that fits modern delivery stacks.

AreaPowerMTA 4.5PowerMTA 5.0
Email submissionSMTP and legacy Java APIHTTP Transmissions API in addition to SMTP
Event deliveryNo native webhooksWebhook support for queue and accounting events
Web MonitorStatic read-only dashboardRedesigned widget-based monitor with custom views
ConfigurationTraditional file-based directives onlyAdded HTTP listener and API scopes

These changes do not remove SMTP. If your current injection pipeline works over SMTP, it will continue to work after the upgrade. The new HTTP API is additive, giving you an alternative for applications that already speak JSON over HTTP.

HTTP API and Webhooks Explained

PowerMTA 5.0 introduces an HTTP Transmissions API that accepts JSON payloads for message submission. This separates message ingestion from the SMTP listener and is useful for transactional mail, microservices, and serverless functions that do not want to maintain SMTP sessions. The API accepts one or more recipients per request, along with content and optional metadata such as campaign IDs.

The following example shows a minimal submission to a local PowerMTA HTTP listener. The exact port and path depend on your PowerMTA configuration, but the pattern holds for most 5.0 installations:

curl -X POST http://127.0.0.1:8080/api/v1/transmissions \
  -H "Content-Type: application/json" \
  -d '{
        "recipients": ["recipient@example.com"],
        "campaign_id": "welcome-series-2026",
        "content": {
          "from": "sender@yourdomain.com",
          "subject": "Welcome to PowerMTA 5.0",
          "text": "This message was submitted via the HTTP API."
        }
      }'

Webhooks complement the submission API by pushing asynchronous events to a URL you control. Common events include bounce reports, delivery confirmations, and queue state changes. You configure webhook endpoints in the PowerMTA configuration file and secure them with a token. If you run marketing campaigns, pairing PowerMTA with a self-hosted bulk email platform such as Choco Mailer gives you list segmentation and open tracking on top of the MTA’s delivery engine.

If you manage multiple PowerMTA instances, PMTAcore’s PowerMTA Management can provision the HTTP listener settings across servers from a Windows desktop, avoiding per-server manual edits.

Improved Web Monitor and Customization

The Web Monitor in PowerMTA 5.0 has been redesigned for navigability and customization. Instead of a fixed set of read-only charts, you can arrange widgets for queue depth, delivery rates, bounce categories, and per-domain throughput. Custom views persist per user, and you can filter by VMTA, domain, or time window.

Key monitor improvements include:

  • Custom dashboard widgets for queue, accounting, and bounce metrics.
  • Per-VMTA and per-domain filters that replace the old global view.
  • Persistent user preferences for each operator login.
  • Exportable snapshots for sharing with deliverability teams.

Access the monitor at http://server-ip:8080/ after enabling HTTP access. Set up alerts based on sustained queue build-up rather than single spikes. A queue that stays above threshold for five minutes is more actionable than a momentary burst. For broader server and IP monitoring, see PowerMTA Management documentation.

Step-by-Step Upgrade from 4.5 to 5.0

Before upgrading, back up your configuration, verify your current version, and review the release notes for any deprecated directives. Test the upgrade on a staging server first. The following procedure assumes an RPM-based Linux distribution such as AlmaLinux or Rocky Linux on x86_64.

# 1. Record current version
pmta --version

# 2. Stop PowerMTA
systemctl stop pmta

# 3. Back up the configuration directory
cp -a /etc/pmta /etc/pmta.bak.$(date +%Y%m%d)

# 4. Install the 5.0 package (example for Rocky Linux 9)
rpm -Uvh pmta-5.0r1.x86_64.rpm

# 5. Restart and verify
systemctl start pmta
pmta --version
pmta show status

After the upgrade, perform these validation steps in order:

  1. Confirm the new version with pmta --version.
  2. Inspect /var/log/pmta/accounting.csv for fresh delivery events.
  3. Send a test message through SMTP on port 25, then through the HTTP API.
  4. Watch queue depth for two hours under normal traffic.
  5. Check Web Monitor widgets for expected metrics.

If you would rather not run these commands manually on each server, PMTAcore’s automated installation can push the same package to multiple servers over SSH. The desktop app supports PowerMTA versions 4.5r1 through 6.0r3 and performs the backup, upgrade, and restart steps without leaving the GUI.

Compatibility and Rollback Considerations

Most 4.5 configuration directives carry forward unchanged, but you should check for deprecated SMTP options and new HTTP listener blocks before starting the service. If you have custom monitoring scripts that parse the old Web Monitor HTML, expect them to break; the new monitor uses a JSON backend that is more reliable for automation.

Rolling back is straightforward: stop PowerMTA, restore the backup configuration directory, and reinstall the previous RPM. Keep the old package file and the backup directory on the server for at least one billing cycle. Test HTTP API authentication and payload validation before switching production traffic away from SMTP.

A common question is why Gmail limits you to 10 messages per day—that is a constraint on consumer Gmail accounts, not on PowerMTA. When you send through your own PowerMTA server, Gmail’s sending limit does not apply, but Gmail’s bulk sender requirements do: you must publish SPF and DKIM, set DMARC, and implement one-click unsubscribe for marketing mail. Yahoo’s 2026 changes follow the same pattern. If you need to automate DNS record creation for new sending domains, PMTAcore’s Auto DNS Apply handles SPF, DKIM, DMARC, and MX records across Cloudflare, GoDaddy, and Namecheap.

When you are ready to move to 5.0, start with a staging server or a low-traffic VMTA. Start your free trial of PMTAcore to test the upgrade workflow without committing to a licence.

#powermta 5.0 features#powermta 5.0 new features#powermta upgrade guide#powermta 2026 changelog#http api powermta#web monitor powermta