---
title: "Install Overview"
description: "Check platform requirements, download the right Cloud Link package, verify its checksum, and choose the correct desktop or headless installation path."
canonical: "https://opencodecloud.link/docs/install/"
lastUpdated: "2026-10-19"
---
Cloud Link ships as four downloads. Every file resolves to the latest GitHub
release and includes pinned, integrity-verified OpenCode and cloudflared.

| Platform | File | Best for |
| --- | --- | --- |
| macOS (Apple silicon + Intel) | [`opencode-cloudlink_darwin_universal.dmg`](https://github.com/alvarolorentedev/opencode-cloud-link-releases/releases/latest/download/opencode-cloudlink_darwin_universal.dmg) | Menu-bar app |
| Windows x64 | [`opencode-cloudlink_windows_amd64.exe`](https://github.com/alvarolorentedev/opencode-cloud-link-releases/releases/latest/download/opencode-cloudlink_windows_amd64.exe) | System-tray app |
| Linux x64 | [`opencode-cloudlink_linux_amd64.tar.gz`](https://github.com/alvarolorentedev/opencode-cloud-link-releases/releases/latest/download/opencode-cloudlink_linux_amd64.tar.gz) | Headless server or CLI |
| Linux ARM64 | [`opencode-cloudlink_linux_arm64.tar.gz`](https://github.com/alvarolorentedev/opencode-cloud-link-releases/releases/latest/download/opencode-cloudlink_linux_arm64.tar.gz) | ARM64 servers and compatible Raspberry Pi systems |

The [download page](/download/) has the same files. Each release publishes a
matching `.sha256` sidecar.

## Requirements

| Platform | Minimum |
| --- | --- |
| macOS | macOS 15 or newer; Apple silicon or Intel |
| Windows | x64 Windows; WebView2 (provisioned by the installer) |
| Linux | glibc 2.39 or newer (for example Ubuntu 24.04 or Debian 13); x64 or ARM64 |

`armv7` is not supported. Windows ARM64 has no installer. Linux GUI installers
and DEB/RPM packages are not part of the current distribution.

OpenCode and cloudflared are bundled. You do not need Go, Rust, Node, a
Cloudflare account, port forwarding, or a manually created tunnel.

An active Cloud Link subscription is required. Buy or restore it inside
OpenCode Mobile before pairing. See
[Subscription and billing](/docs/subscription/).

## Verify the download

Each release asset has a `.sha256` sidecar. Compare it before running or
extracting the file.

### macOS or Linux

```sh
shasum -a 256 opencode-cloudlink_darwin_universal.dmg
# compare with the matching .sha256 sidecar
```

```sh
sha256sum opencode-cloudlink_linux_amd64.tar.gz
# compare with the matching .sha256 sidecar
```

### Windows PowerShell

```powershell
Get-FileHash .\opencode-cloudlink_windows_amd64.exe -Algorithm SHA256
# compare the hash with the matching .sha256 sidecar
```

If the hashes differ, delete the download and fetch it again from
[GitHub Releases](https://github.com/alvarolorentedev/opencode-cloud-link-releases/releases).

## Choose your platform

- **[macOS](/docs/install/macos/)** — open the DMG and drag the app into
  Applications.
- **[Windows](/docs/install/windows/)** — run the NSIS installer. It is
  currently unsigned, so SmartScreen may warn.
- **[Linux and headless](/docs/install/linux/)** — extract the archive, run the
  connector in the foreground, or install the optional systemd user service.

## Updates and removal

Cloud Link does not install an automatic updater. To update, download the
current release and install it over the existing version. Pairing identity,
settings, and exposed services are stored outside the application bundle and
survive a normal reinstall.

To uninstall, stop the connector or quit the tray app, then remove the
application or extracted archive. Saved configuration and credentials are
retained for a future reinstall; remove them explicitly if you want a clean
state. Deleting the machine through the mobile app retires its tunnel and DNS
record. Per-device revocation is not implemented.

See [Releases and updates](/docs/releases/) for version checks and state
locations.

## Before you pair

You need the Cloud Link subscription active and OpenCode Mobile open on the
Cloud Link screen. Keep the machine's QR code visible and be ready to approve
the device on the machine. Continue with
[Pair with OpenCode Mobile](/docs/pairing/).