Client Installation¶

Quick Install (Recommended)¶

The universal installer auto-detects your OS and architecture, downloads the correct binary, verifies its checksum, and sets up configuration:

curl -fsSL https://assets.rvpn.org/install.sh | sudo bash

For interactive setup (prompts for server address, DNS, split tunnel, etc.):

curl -fsSL https://assets.rvpn.org/install.sh | sudo bash -s -- --setup --client

Options:

Flag	Description
`--version X.Y.Z`	Install specific version
`--client-only`	Client only (default prompt)
`--server-only`	Server only
`--install-dir DIR`	Custom install path (default: `/usr/local/bin`)
`--service`	Create systemd/LaunchDaemon service

Manual Install¶

If you prefer to download manually, here are the available binaries:

Binary	Platform
`rvpn-macos-universal`	macOS Universal (arm64 + x86_64)
`rvpn-x86_64-linux-gnu`	Linux x86_64 (glibc, most systems)
`rvpn-aarch64-linux-gnu`	Linux ARM64 (glibc)
`rvpn-armv7-linux`	Linux ARMv7
`rvpn-x86_64-linux-static`	Linux x86_64 (static/musl)
`rvpn-aarch64-linux-static`	Linux ARM64 (static/musl)
`rvpn-x86_64-freebsd`	FreeBSD x86_64
`rvpn-android.apk`	Android (APK)

macOS¶

curl -LO https://assets.rvpn.org/1.0.2/rvpn-macos-universal
chmod +x rvpn-macos-universal
sudo mv rvpn-macos-universal /usr/local/bin/rvpn

# Remove Gatekeeper quarantine flag
xattr -d com.apple.quarantine /usr/local/bin/rvpn

Security note: Official macOS binaries are signed by PDG Global Limited. If you download a binary from another source that is not signed by us, do not use it.

Linux (x86_64)¶

curl -LO https://assets.rvpn.org/1.0.2/rvpn-x86_64-linux-gnu
chmod +x rvpn-x86_64-linux-gnu
sudo mv rvpn-x86_64-linux-gnu /usr/local/bin/rvpn

If you get a glibc version error, use the static build:

curl -LO https://assets.rvpn.org/1.0.2/rvpn-x86_64-linux-static
chmod +x rvpn-x86_64-linux-static
sudo mv rvpn-x86_64-linux-static /usr/local/bin/rvpn

FreeBSD¶

fetch https://assets.rvpn.org/1.0.2/rvpn-x86_64-freebsd
chmod +x rvpn-x86_64-freebsd
sudo mv rvpn-x86_64-freebsd /usr/local/bin/rvpn

Android¶

Google Play (recommended): Install from Google Play

Direct APK download:

curl -LO https://assets.rvpn.org/1.0.2/rvpn-android.apk

Then open the APK on your Android device to install it. You may need to enable "Install unknown apps" for your browser or file manager.

Requires Android 14+ (API 35+).

Verifying the Download¶

curl -LO https://assets.rvpn.org/1.0.2/rvpn-x86_64-linux-gnu.sha256
echo "$(cat rvpn-x86_64-linux-gnu.sha256)  rvpn-x86_64-linux-gnu" | sha256sum -c

Initial Setup¶

Once installed, generate your client identity key:

rvpn keygen -o /etc/rvpn/identity.key

Then obtain prekey-bundle.json from your server operator and place it at /etc/rvpn/prekey-bundle.json.

See the Quick Start for the full setup walkthrough.