Documentation › User Guides › Device Owners › Stage 2 › Install the agent

Device Owner mode launches Q3 2026. The screens and flows described below are based on the implementation under active development. We'll update these chapters with final screenshots and verified click-paths at launch. If you're a Device Owner early-access tester, expect minor UI differences and please report anything that doesn't match.

Install the Zyra Agent on your device

Stage 1 walked you through a quick Windows/macOS install in chapter 3. This Stage 2 chapter goes deeper: cross-platform options (including Linux), exact system requirements, and what to do when the standard installer doesn't fit.

Time: 10-20 minutes depending on platform. Prerequisites: You have a Zyra account (Stage 1) and admin rights on the device.

Where to download

When device-owner mode opens, all installers will live at app.getzyra.io/download. The page auto-detects your OS but you can pick manually:

Windows 10 / 11 — zyra-agent-setup.msi
macOS 12 Monterey or newer — zyra-agent.dmg (universal binary: Apple silicon and Intel)
Linux — .deb (Debian/Ubuntu) and .rpm (Fedora/RHEL) packages [VERIFY: exact distro list and architectures supported at launch]

[SCREENSHOT: download page OS picker]

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, Linux kernel 5.10+	Win 11, macOS 14, Ubuntu 22.04+

If you fall below the minimum, the agent installs but refuses to register and tells you which spec is short.

Apple silicon vs Intel Mac

The macOS .dmg is a universal binary — one download, both architectures. Apple silicon Macs (M1/M2/M3/M4) get a small performance edge for ML workloads because we ship Metal-accelerated containers when the host supports them.

Linux install

Debian / Ubuntu (.deb):

sudo dpkg -i zyra-agent_<version>_amd64.deb
sudo systemctl enable --now zyra-agent

Fedora / RHEL (.rpm):

sudo rpm -i zyra-agent-<version>.x86_64.rpm
sudo systemctl enable --now zyra-agent

The agent runs as a systemd service named zyra-agent. Logs go to /var/log/zyra/agent.log (and journalctl -u zyra-agent). Linux installs are headless by default — pair via long-form token in chapter 2.

What the installer does

Drops the agent binary into the standard location for your OS.
Registers a service (Windows Service, macOS launchd, Linux systemd) set to start on boot.
Creates a working directory for sandboxed task execution.
Opens an outbound TLS websocket to Zyra's coordinator — never accepts inbound connections.

Troubleshooting

Antivirus blocks the installer. The agent is code-signed. Add an exception or contact hello@getzyra.io.
Linux: dpkg complains about missing dependencies. Run sudo apt-get install -f.
macOS: "Zyra Agent can't be opened". System Settings → Privacy & Security → Open Anyway.

What's next

2. Register your device →

Last reviewed: 2026-05-21