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

> Bind a Windows machine to your Glasswarp account. The PC owner does not log in.

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

<Steps>
  <Step title="Install on the Windows PC (no login)">
    Send [glasswarp.com/downloads](https://www.glasswarp.com/downloads) to the
    owner, or install yourself on that machine. See
    [Install the host](/get-started/install-host).
  </Step>

  <Step title="Paste the tray code on your account">
    On your laptop, sign in and open
    [glasswarp.com/pair](https://www.glasswarp.com/pair). Enter the code
    (`ABCD-1234`). That binds the PC to **your** tenant.
  </Step>

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

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

## Eligibility

An API session can start only when both are true:

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

```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 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](/guides/keep-rig-awake).

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.