Register your device
The agent is installed (chapter 1). Now we pair it with your Zyra account so the coordinator knows who owns it and where to send earnings. This step also runs capability detection — the scan that decides which jobs your device qualifies for.
Time: 2-5 minutes. Prerequisites: Agent installed, account created (Stage 1), internet connection.
Step 1 — Launch the agent for the first time
On Windows and macOS the agent opens automatically after install. On Linux, run zyra-agent --pair from a terminal once.
You'll see the Pair with your account screen — a 6-digit code field on top and a "Use token instead" link below for headless setups.
Step 2 — Sign in on the dashboard
On any browser, go to app.getzyra.io/devices/add and sign in. The page shows:
- A 6-digit code that rotates every 10 minutes
- A Show advanced link revealing a long-form token (for SSH / Linux installs)
Step 3 — Enter the code in the agent
Type the 6-digit code into the agent window and click Pair. The agent contacts Zyra's coordinator, exchanges credentials, and registers the device under your user ID. You only do this once per device.
If the code expires, refresh the dashboard page; a new one appears instantly.
Step 4 — Capability detection runs automatically
Right after pairing, the agent scans your hardware and reports:
- CPU cores and clock speed
- RAM (total and free)
- Disk space available for the task sandbox
- GPU model and VRAM (if present)
- OS + version, Docker availability (Windows desktops only)
These specs feed your capability score, a 0-1000 number that determines which jobs your device qualifies for. Verified formula:
- Desktop / laptop: up to 300 from CPU cores + 300 from RAM + 400 from GPU VRAM
- Android device: up to 400 from CPU + 600 from RAM (no GPU)
A modern gaming PC typically scores 600-900. A 5-year-old laptop scores 200-400. You'll see your score on the dashboard within ~30 seconds.
Step 5 — Confirm in your dashboard
Open app.getzyra.io/devices (toured in Stage 1 chapter 5). Your newly paired device should appear with a default name (hostname), Online status, capability score, and hardware summary.
If the device doesn't appear within 30 seconds, check the agent log (see chapter 1 troubleshooting). Most failures are outbound-firewall related.
Naming and grouping
Give each device a memorable name ("Gaming PC", "Kitchen Mac mini"). If you eventually register multiple devices, names make the dashboard much easier to read. [VERIFY: device-groups feature availability at launch]
What the registration record stores
The coordinator stores: device ID (UUID), your user ID, device name, hardware specs (JSON), capability score, OS, and status. It does not store files, browser history, personal data, or location beyond country-level (only if you opt into marketplace mode, future phase).
What's next
3. Your first qualifying job →
Last reviewed: 2026-05-21