Island Pairing

Connect your desktop, server, or mobile device as an Island

Pairing connects your hardware to the Archipelag.io network as an Island so it can receive and execute AI inference jobs. There are two pairing methods: desktop/server and mobile.

Desktop and server pairing

Pair a machine running the Island software at /pair.

{% step(title="Download the Island software") %} Get the latest release from [GitHub](https://github.com/archipelag-io/node-agent). See the [Island setup guide](/getting-started/for-hosts/) for installation instructions.

Run the Island software

Start the Island software — it will display a **6-character pairing code** in the terminal. This code expires after 10 minutes. ``` Pairing code: A3X9K2 Enter this code at https://app.archipelag.io/pair ```

Enter the code

Visit `/pair` in your browser and enter the pairing code. The field auto-capitalizes and accepts only alphanumeric characters.

Paired

On success, the Island is linked to your account and appears in your [settings](/settings) under "Your Islands."

{% end %}

Mobile device pairing

Pair an iOS or Android device at /pair/mobile.

{% step(title="Open the pairing page") %} Visit `/pair/mobile` in your browser. A QR code is generated containing the pairing code and coordinator URL.

Scan with the Archipelag.io app

Open the Archipelag.io app on your mobile device and scan the QR code. The app connects using the embedded pairing code.

Confirm pairing

The web page updates in real-time as the pairing completes. Your mobile device is now registered as an Island.

{% end %}

Mobile runtimes

iOS devices use CoreML with Apple Neural Engine acceleration. Android devices use ONNX Runtime with hardware acceleration. The coordinator automatically routes compatible Cargos to mobile Islands.

Managing paired Islands

View and manage all your paired Islands in /settings under the “Your Islands” section.

Each Island card shows:

Field	Description
Status	Online (green) or offline indicator
Hardware	GPU model, VRAM, CPU cores, total RAM
Karma	Reputation score with progress bar to next level
Jobs completed	Total successful jobs (green)
Jobs failed	Total failed jobs (red)
Earnings	Total credits earned
Last heartbeat	When the Island last checked in

Click “Refresh Islands” to manually update status information.

Build karma early

Keep your Island online consistently to build karma. Higher karma means more jobs routed to your Island and higher earnings. See the [karma reference](/reference/karma/) for details.

Disconnection penalties

Extended disconnections reduce your karma score. If you need to take an Island offline, gracefully shut down the Island software rather than killing the process.

{% card(title="Island Setup Guide", href="/getting-started/for-hosts/") %} Complete installation and configuration

Karma System

How reputation scoring works

Browser Island

Run compute in your browser instead

{% end %}