# PiecesOS support — Pieces

Troubleshoot PiecesOS, locate logs and storage, and install it manually.

[← All support](/support)

## PiecesOS Help & Learning

Fix launch and connection issues, manage on-device storage, and find the logs support needs.

Work through launch, connection, and platform-specific fixes.
Install or replace PiecesOS without the combined suite installer.
Collect recent logs before opening a bug report.
Locate local databases, backups, and storage folders.

## Quick fixes

### PiecesOS won't start or keeps crashing

PiecesOS may fail to launch if it was installed to a cloud-synced folder, the OS is outdated, or Windows Controlled Folder Access is blocking writes.

1. Confirm your OS meets minimum requirements: macOS 12+, Windows 10 1809+, or Ubuntu 22+.
2. If installed to OneDrive, iCloud Drive, or another synced location, uninstall and reinstall to the default path.
3. On Windows, add `PiecesOS` to the Controlled Folder Access allowlist if CFA is enabled.
4. Restart your computer and reopen Pieces Desktop.

PiecesOS troubleshooting guide

### PiecesOS update failed or stuck

Updates can fail if the previous version is still running or if the installer file is blocked.

1. Quit Pieces Desktop and PiecesOS completely (use Task Manager or Activity Monitor if needed).
2. Open Pieces Desktop again. It will relaunch PiecesOS and prompt for the update.
3. On Windows with `.appinstaller`, quit both apps before retrying the update.
4. If updates continue to fail, download the latest installer from the manual installation guide.

[Manual installation guide](https://docs.pieces.app/products/core-dependencies/pieces-os/manual-installation)

### Where are my logs and local data?

PiecesOS stores logs and databases locally. Attach recent logs when reporting a bug.

- **macOS:** `~/Library/com.pieces.os/production/Support/logs/`
- **Windows:** `%LOCALAPPDATA%\\Mesh Intelligent Technologies, Inc\\Pieces OS\\com.pieces.os\\production\\Support\\`
- **Linux:** `~/.local/share/com.pieces.os/logs/`

Zip the latest two or three log files and attach them to your GitHub issue or support request.

[Logs and storage guide](https://docs.pieces.app/products/support#finding-your-logs)

## Browse PiecesOS topics

Open the canonical Pieces documentation for each dependency or task.

## Still need help?

Try the troubleshooting guide first, then include recent logs in your report.

Ask the team and other Pieces users about your PiecesOS setup.
Report a reproducible PiecesOS bug and attach recent logs.
Send diagnostic details directly when GitHub is not the right fit.
Use a call when the docs and support channels have not resolved the issue.