Installation Guide | Linux

The following guide will help you install and run both PiecesOS and the Pieces for Developers Desktop Application quickly and easily on your Linux device.

Install Pieces for Linux

Follow the steps below to download and install Pieces for Linux using the Command-Line Interface (CLI).

Requirements

There are several requirements that your Linux device must meet to download and install the Pieces Desktop App, PiecesOS, and ensure LTM-2 compatibility.

  • Snap Support: Ensure snapd is installed and enabled on your system. Most recent Ubuntu releases include snapd by default. If needed, install snapd by following the official snapd documentation.

  • Administrator Access: You’ll need sudo privileges to install snap packages.

  • Minimum OS Type: PiecesOS has been tested and developed primarily for Ubuntu 22+ or later-based distributions, so make sure your system is updated to at least Ubuntu 22+ or later.

  • X11 Window Manager: Virtual Linux machines or dedicated instances of Linux, even PiecesOS-compatible Ubuntu 22+ distributions, must utilize X11 as the proprietary Window Manager.

To determine which display manager your Linux device is using, go to Settings, then System, and System Details to see if you are using an X11 or a non-LLVM compatible manager.

Download — Linux
Download — Linux

Ubuntu 22.04+ required.

Run these commands in order to install and properly set up the Pieces Desktop App and it’s core dependencies:

  1. sudo snap install pieces-os

  2. sudo snap connect pieces-os:process-control :process-control

  3. sudo snap install pieces-for-developers

Then, type pieces-for-developers to launch the application directly from your terminal.

Your Linux device must be running a supported distribution of Ubuntu—Ubuntu 22+.

Click here for documentation on determining your OS version.

Installation Method

Installation of PiecesOS and the Pieces Desktop App on supported Linux systems is done using the terminal (CLI).

Post-Installation Tips

Read the documentation below for tips and information to ensure you’re up and running with the latest versions of PiecesOS and the Pieces Desktop App, as well as steps to uninstall Pieces software from your Linux device.

Updating

The Pieces Desktop App automatically downloads and installs new updates.

You can also manually check for updates to PiecesOS and the Pieces Desktop App by clicking the profile icon nested in the search bar at the top of your Pieces Desktop App view, then selecting Check for Desktop App Updates or Check for PiecesOS Updates.

Uninstalling

You can uninstall PiecesOS and the Pieces Desktop App using snap commands directly from your terminal.

When running both of these commands, you will be prompted to enter your device’s local account password due to the sudo command.

1

Removing the Pieces Desktop Application

Type sudo apt remove pieces-for-developers and press enter.

2

Removing PiecesOS

Type sudo apt remove pieces-os and press enter.

3

Removing Unused Dependencies (Optional)

Type sudo apt autoremove and press enter.

Additional Resources

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

Updated on
Installation Guide | macOS
Troubleshooting