Skip to content

Configuration Internals

realstuffie edited this page Mar 22, 2026 · 3 revisions

Configuration Internals

Keyring

ProxMon stores the API token secret in the system keyring via qtkeychain. The keyring backend is selected automatically — KWallet on KDE, libsecret on GNOME. The secret is keyed by apiTokenSecret:tokenId@host:port. Removing and re-adding the widget, Kwallet keys are auto detected and loaded automatically.

Connection tab

Field Notes
Host Proxmox IP or hostname
Port Default: 8006
API Token ID Format: user@realm!tokenname
API Token Secret Secret from token creation
Update Keyring Migrates new secret into keyring
Forget Clears secret field only, does not delete keyring entry
Refresh Interval Update frequency in seconds (default: 30)
Ignore SSL Enable for self-signed certificates

Behavior tab

Network

Field Notes
Low latency mode Reduces request timeout to 5s (default: 10s). Recommended for LAN. Disable for WAN or high-latency connections.

Notification rate limiting

Configurable minimum interval between duplicate notifications (default: 120s). Enable in Behavior tab → Rate Limiting.

Notification privacy

Sensitive identity fragments are redacted from notification text by default. Replaces user@realm!tokenid with REDACTED@realm!REDACTED. Toggle in Behavior tab → Privacy.

Reliability

If one node in a cluster is unreachable, ProxMon continues displaying data from the remaining online nodes rather than showing a full error screen. A ⚠ indicator appears in the footer timestamp when partial data is being shown. The compact representation CPU% excludes offline nodes from the average.

Clone this wiki locally