PiecesOS | Manual Installation

Find standalone download links for PieceOS that match your system’s operating system (OS) or architecture, or download PiecesOS automatically with the Pieces Desktop App.

Manual Installation Guide

To get started, you’ll need to make sure your device is compatible with Pieces and has the minimum device recommendations.

Checking Device Specifications

For macOS, Windows, and Linux devices, we recommend having at least:

a 4-core processor
8gb of RAM
1.5gb of install space

PiecesOS and the Pieces Desktop App are lightweight, but you want to ensure you’ve got at least the above specifications to ensure a seamless user experience.

Checking OS Version

PiecesOS is designed for macOS, Windows, and Linux, so you have the power of Pieces are your fingertips regardless of your device’s operating system.

Still, you need to be running a minimum version of that OS to ensure compatibility.

macOS	Windows	Linux
macOS 12.0 (Monterey) or higher	Windows 10 (v.1809) or higher	Ubuntu 22+

For Linux users, please note that PiecesOS is tested and currently compatible with Ubuntu 22+ and other Ubuntu-based distributions only.

If you need help determining your device’s OS version or system specifications, read this documentation on the Troubleshooting page.

Why Install PiecesOS Manually?

PiecesOS is installed by default when installing the Pieces Desktop App as a core dependency, but it can be installed manually for use with a Pieces plugin or extension if you’re not ready to dive into the entire Pieces ecosystem.

The LTM-1, Pieces Drive, and Pieces Copilot will still be available to you.

Installing via Pieces Desktop App

If you want to install PiecesOS automatically alongside the Pieces Desktop App, you can check out these installation guides.

PiecesOS Download Links

There are different ways to install PiecesOS as a standalone entity, separate from the Pieces Desktop App.

To install, download the appropriate link for your device’s OS and architecture (if using a macOS device) and open the file, then walk through the guided installation steps as necessary.

Apple Devices

There are different downloadable packages for macOS depending on device architecture.

Please make sure to download the correct .dmg file, or else PiecesOS will not be functional. If you are unsure how to determine the file type you need, refer to this documentation here.

macOS (Apple Silicon / ARM)

PiecesOS .dmg ARM64 (Standalone Mac)

macOS (Intel)

PiecesOS .dmg (Standalone Mac)

Installing via Homebrew

You can also install PiecesOS manually using Homebrew from your device’s terminal.

To do so:

Ensure Homebrew is installed on your system.
Run brew install --cask pieces in your terminal to install the Pieces brew package.

Uninstalling PiecesOS

Select your operating system below to platform-specific steps to uninstalling PiecesOS.

On macOS Devices

On your macOS device, navigate to Finder, then select Applications.

Scroll or search until you find PiecesOS. Right-click on these two applications and select Move to Trash.

Troubleshooting

If you’re experiencing issues related to the manual installation of PiecesOS, see the troubleshooting guide for quick fixes or access the support page for helpful resources.

Want to install PiecesOS automatically with the Pieces Desktop App? Click here.