Pulse/docs/MAIL_GATEWAY.md

Proxmox Mail Gateway (PMG) Monitoring

Pulse 5.0 adds support for monitoring Proxmox Mail Gateway instances alongside your PVE and PBS infrastructure.

Features

• Mail Queue Monitoring: Track active, deferred, and held messages
• Spam Statistics: View spam detection rates and virus blocks
• Cluster Status: Monitor PMG cluster node health
• Quarantine Overview: See quarantine size and pending reviews

Adding a PMG Instance

Via Settings UI

1. Navigate to Settings → Infrastructure
2. Click Add Node
3. Select Proxmox Mail Gateway as the type
4. Enter connection details:
   • Host: Your PMG IP or hostname
   • Port: 8006 (default)
   • Username: e.g., root@pam or a dedicated api@pmg user
   • Password: the PMG account password

Via Discovery

Pulse can automatically discover PMG instances on your network:

1. Enable discovery in Settings → System → Network
2. Go to Settings → Infrastructure
3. PMG instances on port 8006 are detected and shown in the Proxmox discovery panels
4. Click a discovered PMG server to add it

Service Account Setup on PMG

PMG does not support API tokens. Use a dedicated PMG user with read-only access if possible:

• Create a user in the PMG UI (or CLI) such as api@pmg.
• Assign the minimum permissions needed to read mail statistics and cluster status.
• Use that username and password when adding the node in Pulse.

Dashboard

The Mail Gateway tab shows:

Metric	Description
Mail Processed	Total emails processed today
Spam Rate	Percentage of spam detected
Virus Blocked	Malicious emails caught
Queue Depth	Messages pending delivery
Quarantine Size	Emails in quarantine

Status Indicators

• 🟢 Healthy: Normal operation
• 🟡 Warning: Queue building up or high spam rate
• 🔴 Critical: Delivery issues or cluster problems

Alerts

Configure alerts for PMG metrics in Alerts → Thresholds:

• Queue depth exceeding threshold
• Spam rate spike
• Delivery failures
• Cluster node offline

Multi-Instance Support

Monitor multiple PMG instances from a single Pulse dashboard:

• Compare spam rates across gateways
• Aggregate mail statistics
• View cluster-wide health

Troubleshooting

Connection refused

1. Verify PMG is accessible on port 8006
2. Check firewall rules
3. Ensure the PMG user/password is correct and has read permissions

No statistics showing

1. Wait for initial data collection (may take 1-2 polling cycles)
2. Verify PMG has mail activity
3. Check Pulse logs for API errors

Cluster nodes missing

1. PMG cluster must be properly configured
2. The PMG user needs cluster-wide permissions
3. All nodes must be reachable from Pulse