Install the Compute Node agent on Windows

Step 1 — Generate an enrollment key

Sign in to app.getzyra.io, open Settings → Compute Nodes → Enrollment keys, and click Create key. Give it a description (engineering-laptops, helsinki-office), optionally cap the number of uses, and copy the key. The key is shown once — store it in your IT password manager. The key auto-approves devices that pair with it, so treat it like a secret.

Step 2 — Download the installer

On the target Windows machine, go to app.getzyra.io and click Compute Nodes → Add Compute Node → Windows. You have two equivalent downloads:

• Zyra Agent-1.9.0-win-x64.exe — the full Electron installer, NSIS-based. Best for laptops and workstations where a person will sit in front of the machine occasionally. Includes a tray icon and a small dashboard window.
• zyra-install.bat — a small batch script with the enrollment key embedded. Best for headless servers and bulk rollouts. Downloads the agent zip from app.getzyra.io/api/v1/devices/agent/binary?os=windows, unpacks it to %LOCALAPPDATA%\Zyra, and starts it.

Pick whichever fits your situation. The rest of this chapter walks through the full installer; the batch script is covered in a callout at the end.

Step 3 — Run the installer

Double-click the .exe. Windows will show a User Account Control prompt — the installer requests elevation so it can register a per-user Start Menu shortcut and a "Run at login" entry. Approve it.

The NSIS wizard offers a non-default install location if you need one. Otherwise accept the defaults:

• Install path: %LOCALAPPDATA%\Programs\zyra-desktop-agent\
• Start Menu folder: Zyra Agent
• Desktop shortcut: enabled
• Run after finish: enabled

When the installer completes, the agent launches automatically and lands in the system tray as the small Zyra icon near the clock.

Step 4 — Pair the agent with your organization

The first time the agent runs, it opens a small window asking you to either sign in with your Zyra account or paste an enrollment key. Pick Pair with enrollment key, paste the key from Step 1, and click Validate.

The agent calls POST /api/v1/devices/enroll against app.getzyra.io with the key and the machine's hardware specs (CPU, RAM, GPU, OS). On success the agent stores the assigned device ID in electron-store and starts sending heartbeats every 30 seconds. The window collapses to the tray.

Step 5 — Confirm in the dashboard

Switch back to your browser at app.getzyra.io/devices. Within 60 seconds the new Compute Node appears in the list with:

• A hostname-based name (e.g., LAPTOP-7H2KQ - win32)
• Status Online
• Capability score (a 0-1000 number from CPU, RAM, GPU)
• The hardware specs the agent reported

Chapter 4 covers renaming, tagging, and scheduling. For now, the machine is registered.

What just happened

The Windows agent registered itself with your organization via the enrollment key, so its identity is bound to your tenant. A "Run at login" entry was created (visible at Task Manager → Startup apps), so the agent comes back automatically after a reboot. Heartbeats now flow into your dashboard every 30 seconds.

Troubleshooting

• SmartScreen or Defender blocks the installer. If SmartScreen shows "Unrecognized app", click More info → Run anyway, or use the batch-script path instead.
• Corporate antivirus quarantines the binary. Ask IT to allow-list the install path (%LOCALAPPDATA%\Programs\zyra-desktop-agent\Zyra Desktop Agent.exe) and the executable's SHA-256 hash from the download page.
• Agent shows "Pairing" forever. Almost always a firewall blocking outbound HTTPS to app.getzyra.io. Confirm with curl https://app.getzyra.io/health from PowerShell.
• Headless / Server Core / no UAC. Use zyra-install.bat instead. Run it from an elevated cmd.exe; it writes config.ini with the embedded key and starts the agent silently.