Install Pieces for Linux

Pieces for Linux is available via Snap (recommended for Ubuntu) or Flatpak (for Fedora, Arch, Linux Mint, and other distros). Choose the method that works best for your system.

Snap package for Ubuntu and Snap-supported distributions. Flatpak package for Fedora, Arch, and other distributions. Pieces for Linux installation guide banner

General Requirements

  • Minimum OS: Ubuntu 22+ or equivalent modern Linux distribution
  • Display Server: Pieces is primarily supported on X11. Wayland support requires manual steps. Run pieces-os.doctor after install (Snap only) and follow its output. If Long-Term Memory or screen-related features misbehave, especially in some VMs, try logging in with an X11 session or see Linux troubleshooting.
Check your session with `echo $XDG_SESSION_TYPE` (`wayland` or `x11`). On **Wayland**, use `pieces-os.doctor` to wire up interfaces; labels in **Settings → System** vary by distro.

Additional Resources

Click here for additional documentation on troubleshooting or reach out to support.