Troubleshooting

If the Pieces Desktop App isn't working as expected, start here. This page explains our troubleshooting documentation and guides you to the right solution for your issue.


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.

macOS + Windows + Linux
macOS + Windows + Linux

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.

You can also find additional support resources here.

Updated on