Installation Guide

The Tunnely ecosystem consists of a headless Rust daemon managed by a lightweight React/Tauri desktop interface. Follow the instructions below to install the client securely on your operating system.

System Requirements

Windows: Windows 10/11 (64-bit)
macOS: macOS 11+ (Intel or Apple Silicon)
Linux: Ubuntu 20.04+, Fedora 35+, Arch Linux (NetworkManager required)

Recommended Method: Pre-compiled Binaries

The easiest way to install Tunnely is to download the latest signed release for your platform from our official Download page.

Windows Installation

Download the .msi installer from the download portal.
Run the installer and grant explicit Administrator rights (required for the daemon to configure the virtual network interfaces and WireGuard routes).
Launch "Tunnely" from your Start menu. The app will automatically initialize the headless daemon in the background.

macOS Installation

Download the universal .dmg file.
Open the `.dmg` and drag the Tunnely app into your /Applications folder.
Upon first launch, macOS will prompt you to install a "System Extension" to allow Tunnely to route traffic. Navigate to System Settings > Privacy & Security and explicitly "Allow" the Tunnely extension.

Linux Installation

On Linux, Tunnely interacts directly with NetworkManager and expects resolvconf and wireguard-tools to be available on your system path.

# Debian / Ubuntu Systems
wget https://dl.tunnely.org/tunnely-latest.deb
sudo dpkg -i tunnely-latest.deb
sudo apt-get install -f # to resolve dependencies

Warning: Third-Party Repositories

Do not install Tunnely from unofficial package managers or community mirrors (e.g. AUR packages not maintained by the core team). Due to the nature of network-level routing, compromised binaries could intercept your traffic before cryptography is applied.