---
title: "OpenCode Cloud Link Documentation"
description: "Install OpenCode Cloud Link, pair your machine with OpenCode Mobile, configure settings, expose local services, and fix connection problems."
canonical: "https://opencodecloud.link/docs/"
lastUpdated: "2026-10-19"
---
OpenCode Cloud Link is a paid desktop and headless connector. It publishes the
OpenCode server on your own machine — and the local services around it — to the
OpenCode Mobile app and remote browsers over an authenticated Cloudflare Tunnel.

Your repository, provider credentials, prompts, and build tools stay on your
machine. Cloud Link manages the connection so you can work from your phone
without configuring a VPN, port forward, or tunnel.

Cloud Link is an independent project. It is not built by, endorsed by, or
affiliated with the OpenCode team.

## Choose your starting point

| If you want to... | Start here |
| --- | --- |
| Understand what Cloud Link does | [What is Cloud Link?](/docs/introduction/) |
| Install and connect for the first time | [Quick start](/docs/getting-started/) |
| Download the connector | [Install overview](/docs/install/) |
| Pair a phone or approve a device | [Pair with OpenCode Mobile](/docs/pairing/) |
| Learn the tray app and daily controls | [User manual](/docs/user-manual/) |
| Change a setting | [Settings reference](/docs/settings/) |
| Publish a dev server or dashboard | [Exposed services](/docs/exposed-services/) |
| Fix a connection or pairing problem | [Troubleshooting](/docs/troubleshooting/) |

## The shortest safe path

1. **[Install the connector](/docs/install/)** on the machine that runs your
   OpenCode project.
2. **Open OpenCode Mobile → Settings → Cloud Link** and subscribe or restore
   your purchase.
3. **Scan the connector's QR code** and approve the device on your machine.
4. **Open the machine** in the app and start a small task.

If Cloud Link is new to you, read [What is Cloud Link?](/docs/introduction/)
first. If you already know the product, go straight to the
[quick start](/docs/getting-started/).

## How the pieces fit

| Piece | What it is | Where it runs |
| --- | --- | --- |
| OpenCode Cloud Link | The connector that owns the tunnel and local proxy | Your computer or server |
| OpenCode | The coding agent that owns the project | On the same machine |
| OpenCode Mobile | The phone app that starts and reviews work | Android or iOS |
| Control plane | Pairing, entitlement, and tunnel metadata | Cloudflare |
| Cloudflare Tunnel | The encrypted public path to the connector | Cloudflare edge |

The control plane establishes the connection and then gets out of the way.
OpenCode traffic flows between the app and your machine; it is not stored by
the control plane.

## Platform support

- macOS 15 or newer, Apple silicon and Intel (one universal DMG).
- Windows x64 (desktop tray app; the installer is currently unsigned).
- Linux x64 and ARM64 (headless archive with an optional systemd user service).

Each download includes pinned OpenCode and cloudflared. No Go, Rust, Node, or
Cloudflare account is required at runtime. See
[install requirements](/docs/install/) for the full matrix.

## Get help

- [Troubleshooting](/docs/troubleshooting/) covers pairing, services,
  authentication, and platform failures.
- [FAQ](/docs/faq/) answers the most common product questions.
- [For AI assistants](/docs/for-ai-agents/) lists canonical facts and
  machine-readable endpoints.
- For phone-side features beyond Cloud Link, use the
  [OpenCode Mobile documentation](https://getopencode.app/docs/).