Installing and updating. Portelon updates itself on Windows and macOS, and with your package manager on Linux.
Get Portelon from the download page. On Linux, it needs your desktop’s keyring, such as GNOME Keyring, KWallet or KeePassXC, running and unlocked: it keeps your profile’s encryption key there. Without a desktop, see Servers and CI.
Windows, for every user
Portelon installs for your own Windows account. To install it for every account on the computer, run the installer with --system-level, from an administrator’s prompt. That copy doesn’t update itself: install each new version the same way.
Updates
- Windows and macOS. Portelon installs updates itself.
- Linux. Your package manager installs them with the rest of your system’s updates. When one is out, Update Portelon in Portelon’s menu gives the command, with a Copy button.
Once an update is installed, Portelon’s menu offers to relaunch. Your agents carry on without being connected again.
Uninstalling
Uninstalling takes Portelon out of your agents, and puts their settings back.
Windows. Uninstall Portelon from Settings › Apps.
macOS. Drag Portelon from Applications to the Trash. Your agents are disconnected the next time one of them starts.
Linux. Remove the package:
| System | Command |
|---|---|
| Debian, Ubuntu | sudo apt purge portelon |
| Fedora | sudo dnf remove portelon |
| openSUSE | sudo zypper remove portelon |
| Arch Linux | sudo pacman -R portelon portelon-keyring |
Your agents are disconnected the next time one of them starts, or at once if you first run portelon-mcp agents disconnect --all.
On Arch, also delete the [portelon] section from /etc/pacman.conf, and take Portelon’s key out of pacman with sudo pacman-key --delete 2B8102D9AB17BBC78C933307CC432C280233AEF9.
To leave nothing behind, delete Portelon’s folders too: ~/.config/portelon, ~/.local/share/portelon and ~/.cache/portelon on Linux, and %LOCALAPPDATA%\Portelon on Windows.
Uninstalling doesn’t sign the computer out of your account. Sign it out on your account page to free its place at once; otherwise, its place comes free within three days.