Using the Guides
Click one of the links below to get started troubleshooting on your device—or browse the cross-platform troubleshooting documentation for more general fixes.
Cross-Platform Issues
This guide covers troubleshooting for the Pieces Desktop App and PiecesOS, including updates, connectivity, system requirements, checking hardware specifications, and fixing crashes, and more.

Use the Cross-Platform page if you’re not sure where to begin or if your issue isn’t clearly related to your operating system.
On the Cross-Platform troubleshooting guide, you’ll find:
macOS Issues
This guide shows how to fix installation and update problems with the Pieces Desktop App on macOS.
It includes steps for manual installation using DMG or Homebrew, checking for updates, and confirming your macOS version and CPU type. It also gives steps to solve common system compatibility and installation errors.
Windows Issues
Windows users can find help for fixing problems with the Pieces Desktop App in this guide.
This includes steps for manual installation using .exe or WinGet, how to update the app, solutions for system updates, app dependencies, hardware compatibility, and instructions on checking your Windows version and device specs.
It also covers how to ensure a clean restart after making fixes.

Linux Issues
This guide explains how to troubleshoot the Pieces Desktop App on Linux, including updating via Snap, checking distribution compatibility, and fixing installation or display issues, and more.

Additional Assistance
If you’ve followed the applicable troubleshooting steps and still experience problems, consider visiting our community forums for additional guidance, opening a GitHub issue, or booking a call with our engineers.