---
title: Installation
description: Install the dartpilot desktop app.
---

Install the desktop app on the computer that will stay with the board. Pick the build
for your platform from the [download page](https://dartpilot.app/downloads):

| Platform                  | Installer                                            |
| ------------------------- | ---------------------------------------------------- |
| macOS (Apple Silicon or Intel) | `.dmg`: open it and drag dartpilot to Applications |
| Windows (x64 & arm64)     | `-setup.exe`: run the installer                     |
| Linux (x64 & arm64) / Raspberry Pi | `.AppImage` (self-updating)                 |

On macOS, the app needs **macOS 12 (Monterey) or later on Intel** and **macOS 13.4
(Ventura) or later on Apple Silicon**.

Then:

1. Download and install the app.
2. Open it.
3. Plug in your cameras and check they show up as available devices.

When the app can see your cameras, you're ready to [set up the board](/setup).

## Updates

The desktop app updates itself. On launch it checks
[the release feed](https://get.dartpilot.app/latest.json); when a new version is
available, use **Install update** in the app. You should not need to reinstall.

## Headless venue machines

A board does not need a screen or a desktop session. On Linux or macOS (a
Raspberry Pi, a small mini-PC, or a Mac), install the headless board daemon:

```bash
curl -fsSL https://get.dartpilot.app/headless.sh | sh
```

This installs the board to `~/.local/share/dartpilot` and a service that starts on
boot and restarts on failure: a systemd **user** unit (`dartpilot`) on Linux, a
LaunchAgent (`com.dartpilot.board`) on macOS. The board prints a sign-in code on
first start. Enter the code at
[play.dartpilot.app/device](https://play.dartpilot.app/device) to approve it and
connect the board to your account. It is then controlled over HTTP on port `3000`, and the web app
reaches it over your network. On macOS, allow camera access when macOS asks.

Update it in place:

```bash
dartpilot --update
```

Uninstall with `curl -fsSL https://get.dartpilot.app/install.sh | bash -s -- --uninstall`.
See [Headless boards](/setup/headless) for the service commands, logs, and
troubleshooting. If the cameras are not detected on Linux, add your user to the
`video` group and reboot; on macOS, check camera access in System Settings.
