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

# Install and pair

> Win/Linux download, tray Link action, web authorization, and online checks.

# Install and pair

This is the most important TPA flow: without an agent that is **linked and online**, compute jobs that require the TPA will fail.

## 1. Download and install

1. In the web app, open **Profile → TPA**.
2. Under **Download TPA**, choose **Windows** or **Linux**.
3. Install or unpack the package and **start** the TPA.

<Frame caption="Profile → TPA: Windows/Linux download. Click the image to zoom.">
  <img src="https://mintcdn.com/quanorix/2kJanlhXKp9-dfu0/images/es/tpa-profile-download-dark.png?fit=max&auto=format&n=2kJanlhXKp9-dfu0&q=85&s=77433acb3ea243dc1fbfd49ffbf951dd" alt="Download TPA section with Windows and Linux buttons" width="768" height="140" data-path="images/es/tpa-profile-download-dark.png" />
</Frame>

You should see a **system tray** icon. At first it is usually **gray** with *Quanorix TPA (offline)*.

<Note>
  If download is not available in your environment, Profile shows a configuration notice. In production you should see the package link and version.
</Note>

## 2. Start pairing from the TPA (Link)

You do not need to invent a URL — the TPA opens the browser for you.

1. Right-click (or click) the tray icon.
2. Choose **Link** / **Vincular** (the same action exists as a **Link** button in TPA **Settings**).
3. The browser opens Quanorix pairing (`/agent/pair?code=…`).

<Frame caption="TPA Settings window (Link / Paste code, URLs, and cache). Click to zoom.">
  <img src="https://mintcdn.com/quanorix/HtQX2-PUOssj_LGZ/images/es/tpa-settings.png?fit=max&auto=format&n=HtQX2-PUOssj_LGZ&q=85&s=3359934cc62c943ee14dac84e751e09d" alt="Quanorix TPA — Settings with Online status and Link buttons" width="530" height="296" data-path="images/es/tpa-settings.png" />
</Frame>

<Warning>
  You must be **signed in** to the Quanorix account you want to link. If there is no session, the app asks you to log in and then returns to pairing.
</Warning>

## 3. Authorize in the browser

On the **Link Trading Platform Agent** page:

1. Check the **device** name shown.
2. Click **Link** / **Vincular** to confirm that PC may run compute jobs for your account.
3. Wait for the success message (*Agent linked. You can return to the TPA.*).
4. **Close that browser tab/window** (or use *Go to app*). The TPA no longer needs that page open.

You may also see a short local page like *Linking OK. You can close this window* — close it safely.

## 4. Verify the link

Do **both** checks; one alone is not enough.

### In Profile (web app)

Open **Profile → Agent status**:

| Message                  | Meaning                                   |
| ------------------------ | ----------------------------------------- |
| **No agent linked**      | Pairing did not finish or you unlinked    |
| **Linked (offline) · …** | An agent exists, but it is not online now |
| **Connected · …**        | Linked **and** online — ready for jobs    |

After a successful pairing with the TPA running you should see **Connected** (or at least **Linked** if you just quit the TPA).

<Frame caption="Example: agent Connected (online). Click to zoom.">
  <img src="https://mintcdn.com/quanorix/2kJanlhXKp9-dfu0/images/es/tpa-profile-connected-dark.png?fit=max&auto=format&n=2kJanlhXKp9-dfu0&q=85&s=413ee5d2509774104401fff5e420a88b" alt="Agent status: Connected · TPA" width="768" height="164" data-path="images/es/tpa-profile-connected-dark.png" />
</Frame>

### In the tray (PC)

After web authorization, the icon should move from **gray (offline)** to **green (online)**, tooltip *Quanorix TPA (online)*.

If it stays gray:

1. Confirm you clicked **Link** on the web page (not only opened it).
2. Confirm the TPA is still running.
3. Check network / firewall to the product API.
4. Run **Link** again from the tray.

While a job runs, the icon may turn **blue (running)** and return to green when idle.

## 5. Unlink

* From **Profile**: **Unlink agent**.
* From the TPA: clear local tokens (or pair another machine; a new pairing replaces the active agent).

## Flow at a glance

```
Profile → Download TPA → Install / start
       → Tray gray (offline)
       → Tray menu: Link
       → Browser: sign in → click Link
       → Close pairing tab
       → Profile: Connected · <device>
       → Tray green (online)
```

## Next

* [Data cache](/en/tpa/cache) — first M1 sync and deltas.
* [Troubleshooting](/en/troubleshooting) — failed pairing, offline, blocked jobs.