help

Setup fast.
Repair fast.

These are the canonical DexRelay Mac commands for install, pairing, repair, and uninstall. If something breaks, start with dexrelay status, then dexrelay repair.

Last updated: March 28, 2026

1. Install on Mac

Recommended Homebrew install flow:

brew tap dexrelay-app/dexrelay && brew install dexrelay && dexrelay install

Alternative raw installer:

curl -fsSL https://assets.dexrelay.app/install.sh | bash

The install flow sets up the DexRelay runtime on your Mac, installs the local bridge and helper, and starts the required launch agents.

2. Pair Your iPhone

After install, run this on your Mac and scan the QR in the iPhone app:

dexrelay pair

3. Health and Repair

Use these commands in this order when DexRelay is unhealthy:

  1. Check status.
  2. Confirm Tailscale is actually available on the Mac if you expect remote access.
  3. Run repair.
  4. Rerun install only if repair is insufficient.
dexrelay status dexrelay repair dexrelay install

4. Uninstall

To remove DexRelay from your Mac:

dexrelay uninstall

This removes the DexRelay runtime, launch agents, logs, and the Homebrew CLI if it was installed through Homebrew.

5. Keep-Awake Controls

DexRelay also exposes keep-awake controls for the Mac runtime:

dexrelay wake on dexrelay wake off dexrelay wake status

6. Advanced

Advanced or internal relay bootstrap flow:

dexrelay relay-pair

If you need support or want website signup information deleted, contact [email protected].