Flatpak Repository

Install Peergos
on Linux

Private, end-to-end encrypted storage, social network and application protocol. Follow the steps below to install via Flatpak.

STEP 01

Add the Peergos repository

Add the Peergos Flatpak remote to your system:

terminal
flatpak remote-add --if-not-exists peergos https://flatpak.peergos.org/peergos.flatpakrepo

Also ensure you have Flathub added, as Peergos depends on packages hosted there:

terminal
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
STEP 02

Install Chromium codec support

Peergos uses Chromium for its interface. To enable video playback (H.264/MP4), install the codec extension from Flathub:

terminal
flatpak install flathub org.chromium.Chromium.Codecs
Note: Without this package, MP4/H.264 videos stored in Peergos will not play. VP9 and WebM videos work without it.
STEP 03

Ensure zenity is installed

Peergos uses zenity on the host system for the folder picker when you choose a directory to sync. Most desktops ship it already (check with zenity --version). If it is missing, install it with your distribution's package manager:

debian / ubuntu
sudo apt install zenity
fedora / rhel
sudo dnf install zenity
arch
sudo pacman -S zenity
opensuse
sudo zypper install zenity
STEP 04

Install Peergos

terminal
flatpak install peergos org.peergos.Peergos

Once installed, launch Peergos from your application menu or run:

terminal
flatpak run org.peergos.Peergos
UPDATE

Keeping Peergos up to date

To update Peergos and all its dependencies (including the codec package) at once:

terminal
flatpak update

To update only Peergos:

terminal
flatpak update org.peergos.Peergos
Tip: Most desktop environments will notify you automatically when updates are available. You can also enable automatic updates in your software centre settings.
HELP

Troubleshooting

Videos won't play

Make sure you have installed org.chromium.Chromium.Codecs from Flathub (Step 2 above). Then restart Peergos.

No sound on videos

Ensure PulseAudio or PipeWire is running on your system. Try restarting Peergos. If the issue persists, check that your audio server is not blocked:

terminal
flatpak override --user --socket=pulseaudio org.peergos.Peergos

Security key (WebAuthn) not working

Grant USB device access:

terminal
flatpak override --user --device=all org.peergos.Peergos

Uninstall Peergos

terminal
flatpak uninstall org.peergos.Peergos flatpak uninstall org.chromium.Chromium.Codecs