---

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

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:

• Tips on restarting PiecesOS and Pieces for Developers Desktop App

• Links to common installation issues on your OS

• Links to related documentation on checking hardware specifications on your OS

macOS Issues

The macOS troubleshooting guide provides information and guides on:

• Alternative Installation Methods

• How to verify your macOS version

• Updating the Pieces Desktop App

Windows Issues

The Windows troubleshooting guide provides information and guides on:

• Alternative installation methods for non-Suite installs

• Checking for Windows installation updates

• Verifying the App Installer is up-to-date

• Viewing hardware specifications using dxdiag

Linux Issues

The Linux troubleshooting guide provides information and guides on:

• Confirming compatibility with your Linux distribution

• Using snap commands to update the Pieces Desktop App

• Adjusting graphics settings if you encounter UI issues

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.