# Print agent: install and link

> Install the Windows print agent, link it with an account key, allowed sites, auto update.

Source: https://82label.app/en/docs/agent/

The 82label print agent is a small Windows tray program. While it runs, `print()` sends labels straight to the label printer with no dialog. It is **free for 30 days** from the first link, then **free for subscribers**; it works once linked with an account key.

## Install

1. Get `82label-Setup-version.exe` from [Download](https://82label.app/en/download/) (Windows 10 and 11, 64-bit).
2. It installs without admin rights into your user folder (`%LOCALAPPDATA%\Programs\82label`) and shows a tray icon.
3. It starts with Windows (switch that off in the tray menu).

> If "Windows protected your PC" appears, choose **More info → Run anyway**. SmartScreen can warn about new programs until they have enough downloads. The installer's SHA-256 is on the download page.

## Link your account

1. Sign in to 82label.app and press **New key** in [My templates › Print agent](https://82label.app/en/my/agent/). The key (`l82a_…`) is shown only once.
2. Paste it in tray icon › **Link account…**.
3. When the subscription checks out, the tray shows "Linked". The link is re-checked every 12 hours and keeps printing for 7 days offline.

## Allowed sites

So that no website can print behind your back, the agent checks the requesting site (Origin). For a new site it asks above the tray, "Allow https://shop.example.com to print labels?", and remembers the answer. 82label.app is allowed from the start. Remove sites in tray › Allowed sites.

## Auto update

One minute after start and every six hours it looks for a new version. It installs quietly and restarts only when 82label's update signature checks out and the file from 82label.app matches its size and SHA-256. Turn it off or press "Check for updates" in the tray menu.

## Checking

```js
const s = await Label82.agentStatus();
// null → no agent, or it is not running
// { version: '0.1.0', allowed: true, licensed: true } → prints directly
```

| Symptom | Check |
| --- | --- |
| The browser dialog keeps opening | Is the tray icon there and "Linked"? Does security software block `127.0.0.1:18282`? |
| Nothing prints | With `status: 'pending_permission'`, allow the site in the tray prompt. |
| Positions are off | The driver's paper size and the printer's label sensing calibration. Jobs are always sent at 100%. |