Skip to main content

​
Pairing & Access

FERAL pairing depends on access mode. If mode and network are wrong, QR scans still fail.

​
Modes

​
LAN flow (Same WiFi)

  1. In setup, select Same WiFi.
  2. Go to Devices -> Pair new device -> Web phone.
  3. Click Generate one-time link.
  4. Scan QR on phone.
  5. If PIN is required, type the PIN shown on the Mac.
  6. Tap Pair this device on phone.
If the QR URL is unreachable from phone:
Then regenerate the link.

​
Anywhere flow (Remote / Tailscale Funnel)

Current behavior: setup attempts tunnel activation automatically when you pick Anywhere. If that step fails, use the CLI fallback below (or use Settings -> Access to retry).
  1. In setup, select Anywhere.
  2. If setup fails to bring tunnel up, run:
  1. If prompted, complete Tailscale login (tailscale up) and Funnel enable steps.
  2. Regenerate pairing link from Devices and scan from phone.
Status checks:
Disable remote mode:

​
Pair modal tabs

  • Web phone: default browser-based phone pairing flow.
  • Daemon token: token for SDK/daemon node registration.
  • Native app QR: compatibility QR path for native app flows.
  • Bluetooth: browser BLE scan path.

​
Common errors and fixes

​
Practical note

If you’re intentionally not pairing yet, keep This Mac only and skip all phone steps.