Pair a PC

A PC (API: rig) is a Windows machine running the host agent, paired to your account. Pairing is what lets your API key reach that machine. The person at the PC installs and reads you a tray code. You paste it while logged in. They should not create a Glasswarp account.

Pair

Install on the Windows PC (no login)

Send glasswarp.com/downloads to the owner, or install yourself on that machine. See Install the host.

Paste the tray code on your account

On your laptop, sign in and open glasswarp.com/pair. Enter the code (ABCD-1234). That binds the PC to your tenant.

Confirm it appears online

Open Console → PCs. The machine should show online.

Enable API access

Toggle API access on for that PC. Per-machine owner consent — off by default, required before any API session can route there.

Eligibility

An API session can start only when both are true:

online — the host agent is connected.
api_access_enabled — API access is on.

rig = next(
    (r for r in gw.list_rigs() if r.online and r.api_access_enabled),
    None,
)
if rig is None:
    raise RuntimeError("No online PC with API access enabled")

Keep the PC reachable

Enable Keep awake in that PC’s settings if sessions need to connect at any time. Windows stays awake while the physical monitor can rest. See Keep a rig awake. Next: start your first session.

Get started

Setup

Concepts

Guides

Examples

Help

Pair

Eligibility

Keep the PC reachable

​Pair

​Eligibility

​Keep the PC reachable

Pair

Eligibility

Keep the PC reachable