# Download

Install Pane with the OS-specific shell installer. It resolves the latest release, downloads the right artifact for your machine, and installs or updates Pane.

<OsInstall />

## Package-Manager Alternatives

If you already have Node or Python and want the guided `runpane` CLI, the package wrappers are still available:

<PackageInstall />

For a persistent `runpane` command:

```bash
npm i -g runpane
runpane setup
```

```bash
python -m pip install runpane
python -m runpane setup
```

See [runpane CLI](/docs/runpane-cli) for pnpm, pipx, uvx, explicit daemon commands, and dry-run options.

## Remote VM Setup

The easiest Remote Pane setup is in the app: install Pane normally on the machine that should host your repos and agents, then open **Settings > Remote Pane** and create a `pane-remote://...` connection code. Paste that code into desktop Pane on another machine, or into the browser app at [runpane.com/app](https://runpane.com/app/).

For a headless VM or server, use the remote shell installer on the host:

<RemoteInstall />

If you want the guided CLI instead, choose **Set up this machine as a remote host**:

<RemotePackageInstall />

It prints the same kind of connection code. See [Remote VM Setup](/docs/remote-daemon) for the full flow.

## Nightly Builds

Nightly builds ship the latest changes before they reach the stable channel. Use them to test upcoming features or verify bug fixes. Not recommended for daily driver setups.

<NightlyInstall />

## Direct Download

Download a binary directly from [GitHub Releases](https://github.com/dcouple/Pane/releases/latest).

- **macOS** — universal `.dmg` (Apple Silicon + Intel)
- **Windows** — x64 and ARM64 `.exe` installers
- **Linux** — x64 and ARM64 `.AppImage` and `.deb` packages

<Toggle title="macOS: Gatekeeper warning">

If macOS blocks the app on first launch, open **System Settings → Privacy & Security** and click **Open Anyway** next to the Pane entry. This is a one-time step for apps distributed outside the App Store.

</Toggle>

<Toggle title="Windows: SmartScreen warning">

If Windows Defender SmartScreen shows a warning, click **More info**, then **Run anyway**. The installer is not code-signed for every release yet; this will be resolved in a future release.

</Toggle>

<Toggle title="Building from source">

Clone the repository from [github.com/dcouple/Pane](https://github.com/dcouple/Pane), then:

```bash
pnpm run setup
pnpm run electron-dev
```

Node.js 22 and pnpm are required.

</Toggle>