# Install and update support — Pieces

Install and update Pieces on macOS, Windows, or Linux.

[← All support](/support)

## Install & Update Help

Choose the right installer, confirm compatibility, and fix common setup or update issues.

Understand what Pieces installs and how the apps work together.
Check macOS version, CPU type, permissions, and installer options.
Check system updates, App Installer, dependencies, and hardware.
Confirm distribution compatibility and resolve Snap or display issues.

## Quick fixes

### Cannot open app package: restricted capabilities (Windows)

This usually happens on a Windows PC where you are not an administrator.

1. Try the standalone `.exe` installer instead of `.appinstaller`. It sometimes bypasses App Installer restrictions.
2. If that also fails, search for **Pieces Desktop** in the Microsoft Store. The Store version tends to work better on managed machines.
3. Ask your IT admin to allowlist the Pieces installer if neither option works.

Windows troubleshooting guide

### Wrong architecture or permission denied (macOS)

macOS may block the installer if the CPU architecture does not match or Gatekeeper prevents unsigned apps.

1. Check your chip: click **Apple menu → About This Mac** and look for Apple Silicon (M-series) or Intel.
2. Download the correct installer: Apple Silicon for M1/M2/M3/M4, Intel for older Macs, or Universal if unsure.
3. If macOS says the app cannot be opened, go to **System Settings → Privacy & Security** and click **Open Anyway**.

[macOS troubleshooting guide](https://docs.pieces.app/products/desktop/troubleshooting/macos)

### Snap or package update issues (Linux)

Snap packages may need a manual refresh, or Flatpak repos may not be configured correctly.

1. Run `sudo snap refresh` to update Snap packages.
2. If using Flatpak, confirm the Pieces repo is added (see the Linux guide for the repo URL).
3. Check that your display server (X11 or Wayland) is supported. Some distros require extra display permissions.

[Linux troubleshooting guide](https://docs.pieces.app/products/desktop/troubleshooting/linux)

## Browse install topics

Use the platform guide that matches your computer.

## Still need help?

Include your operating system, version, CPU architecture, and installer type.

Ask for help choosing or running the right installer.
Report a reproducible installer or update problem.
Send system and installer details directly to support.
Use a call when the setup guides and support channels have not resolved the issue.