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.
Download Pieces for Linux
Follow the steps below to download and install Pieces for Linux using the Command-Line Interface (CLI).
Ubuntu 22+ required.
Run these commands in order to install and properly set up the Pieces Desktop App and it’s core dependencies:
-
sudo snap install pieces-os -
sudo snap connect pieces-os:process-control :process-control -
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 support 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.
Removing the Pieces Desktop Application
Type sudo apt remove pieces-for-developers and press enter.
Removing PiecesOS
Type sudo apt remove pieces-os and press enter.
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.