Pair a rig

A rig is a Windows machine running the host agent, paired to your account. Pairing is what lets your API key reach that machine — and only rigs you own.

Pair

After installing the host agent, sign in with your Glasswarp account on the Windows machine. This binds the rig to your account.

Confirm it appears online

Open Console → Rigs. The machine should appear with an online status.

Enable API access

Toggle API access on for the rig. This is per-rig owner consent — off by default, required before any API session can route to it.

Rig eligibility

An API session can start on a rig only when both are true:

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

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 rig with API access enabled")

Wake-on-LAN

If your rig supports it, you can wake a sleeping machine before starting a session:

gw.wake_rig(rig.id)

Next: start your first session.

Install the host agent Your first session

⌘I

Get started

Setup

Concepts

Guides

Examples

Help

Pair

Rig eligibility

Wake-on-LAN

​Pair

​Rig eligibility

​Wake-on-LAN

Pair

Rig eligibility

Wake-on-LAN