Repository navigation
Configuration Internals
ProxMon stores API and PBS token secrets in the system keyring through QtKeychain. QtKeychain picks the backend, which is KWallet on Plasma and the Secret Service when KWallet is missing. The Keyring tab can switch to KeePassXC through the Secret Service, see Using KeePassXC.
Secrets are keyed by apiTokenSecret:tokenId@host:port and pbsTokenSecret:tokenId@host:port. When the configuration is empty, for example after removing and re-adding the widget, ProxMon lists those keys in the keyring and restores the endpoints from them. This works with KWallet and KeePassXC.
| 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 | Skips certificate verification. Prefer a trusted certificate below |
| Trusted certificate | PEM text or a file path, usually /etc/pve/pve-root-ca.pem. Fixes issuer trust, but the host must still match a name or IP in the certificate |
The other tabs and every option are listed in the Configuration reference.
| Field | Notes |
|---|---|
| Low latency mode | Reduces request timeout to 5s (default: 10s). Recommended for LAN. Disable for WAN or high-latency connections. |
Configurable minimum interval between duplicate notifications (default: 120s). Enable in Behavior tab → Rate Limiting.
Sensitive identity fragments are redacted from notification text by default. Replaces user@realm!tokenid with REDACTED@realm!REDACTED. Toggle in Behavior tab → Privacy.
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.