Desktop (macOS)

The desktop app runs as a menu bar app on macOS. It connects to your hubs and relays traffic using your Mac's internet connection.

Install

Download the .dmg from GitHub Releases, open it, and drag Restunnel to Applications.

If macOS says the app is "damaged", run:

xattr -cr /Applications/Restunnel.app

This is a Gatekeeper issue with unsigned apps downloaded from the internet — the app is fine. Code signing is planned for a future release.

Pair with Your Hub

1. Click the Restunnel icon in the menu bar
2. Click Add Hub
3. Paste the noise:// enrollment URL from your hub

The app connects and starts relaying traffic.

Background Behavior

• Runs at login via LaunchAgent — no manual restart needed after reboot
• Auto-reconnects on network changes
• Menu bar icon shows connection status
• Your keypair is stored in the macOS Keychain (hardware-backed on Apple Silicon and T2 Macs)