Troubleshooting

Troubleshooting

Connection errors / "!" indicator

• Verify token ID format: user@realm!tokenname
• For self-signed Proxmox certs, prefer adding the Proxmox root CA PEM (usually /etc/pve/pve-root-ca.pem) in widget settings before using Ignore SSL.
• Trusted certs only fix issuer trust; the configured host must still match a hostname or IP SAN on the server certificate.
• If your cert is valid only for an internal hostname, add local DNS or an /etc/hosts entry and use that hostname in the widget instead of the raw IP.
• Check port 8006 is accessible.

Icons not showing

cp contents/icons/*.svg ~/.local/share/icons/hicolor/scalable/apps/
gtk-update-icon-cache ~/.local/share/icons/hicolor/
kquitapp6 plasmashell && kstart plasmashell

Widget not appearing after install

kquitapp6 plasmashell && kstart plasmashell

If your distro blocks loading the packaged native plugin path:

bash install.sh --install-standalone-qml-module

Logs & auto-rebuild watcher

journalctl --user -f | grep -i proxmox
journalctl --user -g 'ProxMon keyring'   # keyring failures, logged without developer mode
systemctl --user status proxmox-plasmoid-rebuild.path
tail -f ~/.local/share/plasma/plasmoids/org.kde.plasma.proxmox/rebuild.log

Known bugs / limitations

• If you configured the widget in older versions, your API token secret may have been stored under a slightly different keyring key (e.g. due to host casing/whitespace). Legacy keys are no longer auto-migrated and can break the widget. If you see "Missing Token Secret" or odd behavior, open KWallet, remove any ProxMon-related entries, re-enter the secret in settings, and click Update Keyring. Wait a moment, or log out and back in.
• LXC terminal resize, reflow not guaranteed. Resizing the terminal window sends SIGWINCH to the running process, but reflow behavior varies by application. Shells and editors usually redraw correctly; other programs may not reflow until the next render or keypress. This is a quirk of most terminal emulators, not specific to ProxMon.