Install the Zyra device agent (Windows / macOS)
This is chapter 3 of the Device Owner track. By the end you'll have downloaded the agent, installed it, and paired it with your account. From here on, your device is visible in your dashboard.
Time: about 10 minutes (most of it the download and install wizard). Prerequisites: You've passed the eligibility quiz (chapter 2). You have administrator rights on the device you're installing on.
Step 1 — Download the installer
When device-owner mode launches, you'll find the downloads at app.getzyra.io/download. Pick your OS:
- Windows 10 / 11 —
zyra-agent-setup.msi(~[PLACEHOLDER]MB) - macOS 12 Monterey or newer —
zyra-agent.dmg(~[PLACEHOLDER]MB, Apple silicon and Intel both supported) - Linux (Ubuntu 22.04+, Fedora 38+, Debian 12+) —
.deband.rpmpackages
Linux installation is covered in a Stage 2 chapter; this chapter focuses on Windows and macOS, which are the launch platforms for Q3 2026.
System requirements
| Minimum | Recommended | |
|---|---|---|
| CPU | 4 cores, 2.0 GHz | 8+ cores, 3.0+ GHz |
| RAM | 4 GB | 8 GB or more |
| Free disk | 50 GB | 100 GB |
| Internet | 50 Mbps down / 10 up | 100+ Mbps, wired |
| OS | Win 10, macOS 12 | Win 11, macOS 14 |
If you fall below the minimum, the agent will install but refuse to register with the coordinator. You'll see a clear message telling you which spec is short.
Step 2 — Run the installer
Windows
Double-click zyra-agent-setup.msi. Windows User Account Control will prompt for administrator approval — click Yes. The installer takes about two minutes and ends by launching the agent automatically. You should not need to reboot.
The agent installs to C:\Program Files\Zyra\Agent\ and registers itself as a Windows service named Zyra Device Agent. It's set to "Automatic (Delayed Start)" so it doesn't slow your boot.
macOS
Double-click zyra-agent.dmg, drag the Zyra Agent app into Applications, then open it. On first launch macOS will ask you to approve the developer certificate (Gatekeeper) — go to System Settings → Privacy & Security and click Open Anyway. The agent installs a background daemon via launchd.
Step 3 — Pair with your account
After install, the agent opens to a Pair with your account window. You have two options:
- 6-digit code (easiest). Go to
app.getzyra.io/devices/addon any browser, copy the 6-digit code that appears (it rotates every 10 minutes), and type it into the agent. - Long-form token (for headless installs). Click "Use token instead", paste a token from
app.getzyra.io/devices/add → Show advanced. Useful when you're installing via SSH or on a machine without a browser.
Once paired, the agent contacts Zyra's coordinator, declares its hardware capabilities, and flips its status to Idle. Your device should appear in your dashboard within 30 seconds.
What the agent does (and doesn't do)
What it does:
- Connects to Zyra's coordinator over an outbound TLS websocket
- Reports its hardware capabilities and idle status
- Runs jobs the marketplace dispatches to it, inside an isolated sandbox
- Streams metrics (CPU/RAM/network) back so you can see them on your dashboard
What it doesn't do:
- It does not read your files. The sandbox has no access to your filesystem outside the agent's own working directory.
- It does not expose your home network. All connections are outbound; nothing listens for inbound from the public internet.
- It does not run when you're actively using the device, by default. You can configure this under Settings → Activity policy.
Troubleshooting
- Pairing code expired. Codes rotate every 10 minutes. Refresh the dashboard page and try again.
- Antivirus blocks the installer. The agent is signed with our code-signing certificate. Add an exception or email hello@getzyra.io.
- Device never appears in dashboard. Check the agent log: Windows
C:\ProgramData\Zyra\agent.log, macOS~/Library/Logs/Zyra/agent.log. Most failures are outbound-firewall related.
What's next
4. Set up payouts (Stripe Connect) →
Last reviewed: 2026-05-21