Installation

Installation

ProxMon needs KDE Plasma 6.0 or newer and Proxmox VE 7.0 or newer with API access. For KeePassXC support, the libsecret development package is also needed at build time (libsecret-1-dev, libsecret-devel or libsecret). Without it ProxMon builds with KWallet only.

Ubuntu 26.04 (PPA)

The PPA has a package for amd64 and amd64v3:

sudo add-apt-repository ppa:realstuffie/proxmon
sudo apt install proxmon

Update it with sudo apt update && sudo apt upgrade.

If you installed with install.sh before, please use the uninstall script first to remove the old install and its update watcher: bash uninstall.sh. Plasma loads the copy in your home folder before the package, so the old install would keep running. install.sh refuses to run while the package is installed.

Other distributions

git clone --recurse-submodules https://github.com/realstuffie/ProxMon.git
cd ProxMon
bash install.sh

The script handles dependencies, builds the native plugin, installs the plasmoid, and sets up an auto-rebuild watcher that detects library changes (for example a libplasma soname bump) and rebuilds automatically.

Option	Effect
--no-deps	Skip the automatic dependency installation.
--no-watcher	Skip the auto-update watcher.
--cache	Keep the build folder in ~/.cache/proxmon between runs, so a repeat install only recompiles what changed. Meant for development.
--install-standalone-qml-module	Also copy the native plugin and qmldir to the user-local Qt 6 QML module path, for distros that block the packaged plugin path.

Upgrading an install.sh install

cd ProxMon
git pull
bash install.sh --no-deps

Uninstall

./uninstall.sh

Or manually:

kpackagetool6 -t Plasma/Applet -r org.kde.plasma.proxmox
rm -f ~/.local/share/icons/hicolor/scalable/apps/proxmox-monitor.svg
rm -f ~/.local/share/icons/hicolor/scalable/apps/lxc.svg

After either, restart Plasma to remove the widget: kquitapp6 plasmashell && kstart plasmashell.