> ## Documentation Index
> Fetch the complete documentation index at: https://docs.glasswarp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pair a rig

> Link a Windows machine to your account and enable API access.

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

<Steps>
  <Step title="Sign in on the host">
    After [installing the host agent](/get-started/install-host), sign in with
    your Glasswarp account on the Windows machine. This binds the rig to your
    account.
  </Step>

  <Step title="Confirm it appears online">
    Open [Console → Rigs](https://www.glasswarp.com/console). The machine should
    appear with an **online** status.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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.

```python theme={null}
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:

```python theme={null}
gw.wake_rig(rig.id)
```

Next: [start your first session](/get-started/first-session).