Get started

Installation

Install the tun-el CLI on macOS, Linux, or Windows. Choose your preferred method below.

Requirements

64-bit operating system (macOS, Linux, or Windows)
Outbound HTTPS access (port 443)
~10 MB disk space

macOS

Homebrew

Recommended

brew install tun-el/tap/tunel

Shell script

curl -fsSL https://tun-el.dev/install.sh | sh

Manual download

# Download the latest release
curl -LO https://github.com/tun-el/tunel/releases/latest/download/tunel_darwin_arm64.tar.gz
tar -xzf tunel_darwin_arm64.tar.gz
sudo mv tunel /usr/local/bin/

Linux

Shell script

Recommended

curl -fsSL https://tun-el.dev/install.sh | sh

Debian/Ubuntu

# Add the repository
curl -fsSL https://tun-el.dev/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/tunel.gpg
echo "deb [signed-by=/usr/share/keyrings/tunel.gpg] https://tun-el.dev/apt stable main" | sudo tee /etc/apt/sources.list.d/tunel.list
sudo apt update && sudo apt install tunel

Manual download

# Download the latest release (amd64)
curl -LO https://github.com/tun-el/tunel/releases/latest/download/tunel_linux_amd64.tar.gz
tar -xzf tunel_linux_amd64.tar.gz
sudo mv tunel /usr/local/bin/

Windows

Scoop

Recommended

scoop bucket add tun-el https://github.com/tun-el/scoop-bucket
scoop install tunel

Manual download

# Download from GitHub releases
# https://github.com/tun-el/tunel/releases/latest
# Extract and add to PATH

Verify installation

After installing, verify that tun-el is working correctly:

tunel version
# tun-el v1.2.0 (go1.22.0, darwin/arm64)

Build from source

You can also build tun-el from source. Clone the repository and run go build. Requires Go 1.21+.