Skip to Content
InstallationmacOS

Install on macOS

Quick install

curl -fsSL https://dl.rabtly.cloud/install.sh | sh

Then sign in and connect:

rabtly login                        # sign in
sudo rabtly up --token enrt_...    # connect
rabtly status                       # verify

Get your enrollment token from app.rabtly.cloud  → Settings → Access Tokens.

Option A — Menu bar app (recommended)

The menu bar app gives you one-click connect/disconnect from your menu bar.

Download the DMG

curl -fsSL https://dl.rabtly.cloud/latest/rabtly.dmg -o ~/Downloads/rabtly.dmg

Or download from dl.rabtly.cloud/latest/rabtly.dmg .

Install

Open the DMG and drag Rabtly.app to /Applications.

Install CLI tools

Open Rabtly from Spotlight (⌘ Space → Rabtly), then click Install CLI tools in the menu bar. This symlinks rabtly to /usr/local/bin.

Sign in and connect

rabtly login
sudo rabtly up --token enrt_...

Or use the menu bar: click the icon → Connect → enter your enrollment token.

Menu itemWhat it does
● Connected — 100.64.x.xYour assigned VPN IP
Connect / DisconnectStart or stop the VPN
Install CLI toolsSymlinks rabtly to /usr/local/bin
Open DashboardOpens the web dashboard
QuitExit the tray app (does not stop the daemon)

Option B — CLI only (headless / servers)

Use this on a Mac Mini acting as a subnet router, or any headless Mac.

Install

curl -fsSL https://dl.rabtly.cloud/install.sh | sh

Sign in

rabtly login

Connect and register as a service

sudo rabtly up --token enrt_...
sudo rabtly service install       # start at boot via launchd

Service management

sudo rabtly service install       # register launchd daemon + start
sudo rabtly service uninstall     # stop + remove plist
sudo rabtly service start
sudo rabtly service stop

Logs:

tail -f /var/log/rabtly.log

One-command enrollment

Install and connect in a single command:

curl -fsSL https://dl.rabtly.cloud/install.sh | sh -s -- \
  --token enrt_... \
  --control https://api.rabtly.cloud

Update

Re-run the install script — it always fetches the latest version and replaces the binary in place:

curl -fsSL https://dl.rabtly.cloud/install.sh | sh

To pin a specific version, append -s -- --version 1.4.10.

Your config, keys, and enrollment stay intact across updates. Confirm the new version with rabtly version.

Uninstall

# CLI uninstaller — disconnects, then removes binary, config, keys, and state
curl -fsSL https://dl.rabtly.cloud/install.sh | sh -s -- --uninstall
 
# Remove the menu bar app
sudo rm -rf /Applications/Rabtly.app

Troubleshooting

Gatekeeper blocks the app Right-click Rabtly.app → Open → confirm. This is only needed once for unsigned builds.

rabtly: command not found Install CLI tools from the menu bar, or run: sudo ln -sf /Applications/Rabtly.app/Contents/MacOS/rabtly /usr/local/bin/rabtly

rabtly up says “not logged in” Run rabtly login first or pass --token enrt_... directly.

No menu bar icon The app has no Dock icon by design (LSUIElement=true). Check Activity Monitor to confirm it’s running.

OverviewLinux