Step-by-step guide for migrating a Mac fully to AuraVPN as the always-on
default VPN: provisioning a bundle (with the v3.4 server-side static-map
workaround documented as task #52), installing the client binary, configuring
split / full-VPN mode, disabling other coexisting VPNs (the recurring utun4
issue), GUI vs CLI launch, auto-start via LaunchAgent for the GUI tray and
LaunchDaemon for the CLI client, DNS-through-tunnel setup, end-to-end
verification commands, and a full rollback recipe.
Also closes the knowledge gap "where is the .app — I don't see it": we never
ran `npm run tauri build` before, so the GUI lived only as src. §6 covers
building and installing the .app, including the macOS Gatekeeper workaround
for the unsigned v0.1 build.
Includes the empirical confirmation from this session's Phase 1 test
(5/5 ICMP, server tx/rx counters via the #42 fix, RTT 61 ms over the
encrypted TCP/443 tunnel) so the doc has a known-good baseline.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
xah30