---
title: "Quick Start"
description: "Install Cloud Link, subscribe in OpenCode Mobile, pair your machine, approve the device, and confirm your first remote session in a few minutes."
canonical: "https://opencodecloud.link/docs/getting-started/"
lastUpdated: "2026-10-19"
---
This is the shortest path from a new download to a connected machine. For
platform-specific details, use the macOS, Windows, or Linux install guide.

## What you need

- An OpenCode project on a computer or server that can stay online.
- OpenCode Mobile installed from the App Store or Google Play.
- An active Cloud Link subscription (€2.99 per month), purchased or restored in
  the app.
- The Cloud Link connector for your platform.
- A working internet connection on both devices.

The mobile app's Cloud Link section is available only in store-installed iOS
and Android builds. Direct APK, F-Droid/FOSS, and web builds hide the
subscription and machine-management surfaces.

## 1. Install the connector

Download the package for the machine that runs OpenCode:

- [macOS DMG](/docs/install/macos/)
- [Windows x64 installer](/docs/install/windows/)
- [Linux x64 or ARM64 archive](/docs/install/linux/)

Keep bundled tools together with the connector. On macOS and Windows the
installer places the app and its sidecars for you. On Linux, extract the whole
archive rather than copying only the binary.

## 2. Open Cloud Link

Launch the app:

- **macOS:** open **OpenCode CloudLink** from Applications. It appears in the
  menu bar.
- **Windows:** launch **OpenCode CloudLink** from the Start menu. It appears in
  the notification area.
- **Linux:** run `./opencode-cloudlink run --working-directory /your/project`
  in a terminal.

On first launch the connector shows a temporary pairing QR code. It has not
published your machine yet.

## 3. Subscribe or restore in OpenCode Mobile

1. Open **Settings → Cloud Link**.
2. Choose **Subscribe** and complete the App Store or Google Play purchase, or
   choose **Restore purchases** if you already subscribed.
3. Return to the Cloud Link section and keep it open for pairing.

Opening the section does not request camera access, purchase a subscription, or
pair a machine. Those actions happen only after you choose them.

## 4. Pair the machine

1. Keep the connector's QR code visible on the computer.
2. In OpenCode Mobile, tap **Scan QR code**.
3. Scan the code.
4. On the computer, review the device name and choose **Approve**. Choose
   **Deny** if you do not recognize the device.
5. Wait for the app to save the machine credentials and connect.

The tunnel does not start until you approve. Pairing codes expire after five
minutes and work once. If the code expires, choose **Pair device** in the
connector to generate a fresh one.

## 5. Confirm the connection

Open the machine in OpenCode Mobile. A healthy connection shows the project
list and can start a session. In the connector, the OpenCode, Tunnel, and Proxy
status rows should all report ready.

If the app opens but no project appears, refresh **Projects**. If the connector
is retrying, open the popover and choose **Retry** after fixing the reported
problem.

## 6. Start a small task

Use a read-only request for the first check, such as:

> Inspect this project and summarize its purpose. Do not change files.

Confirm that the response arrives and that no files changed. Then try a
contained implementation task and review the diff before accepting it.

## If something fails

| Symptom | Check |
| --- | --- |
| No QR code appears | Wait for the connector to start, then choose **Pair device** |
| QR code is rejected or expired | Generate a fresh code in the connector |
| Pairing waits for approval | Approve or deny the device on the computer |
| Subscription is inactive | Restore purchases or complete the store purchase |
| Machine is listed but cannot connect | Confirm the connector is running and online |
| Browser shows an auth prompt | Use the browser credential from the connector |

For the full checklist, see [Troubleshooting](/docs/troubleshooting/). For the
phone-side subscription flow, see the
[OpenCode Mobile Cloud Link guide](https://getopencode.app/docs/cloud-link/).

## Next steps

- [Pair with OpenCode Mobile](/docs/pairing/)
- [User manual](/docs/user-manual/)
- [Settings reference](/docs/settings/)
- [Exposed services](/docs/exposed-services/)