Installation

onetun is distributed as a single binary, making it easy to install on various platforms.

Pre-built Binaries

You can download the latest binaries for Windows, macOS (Apple Silicon), and Linux (amd64, arm64) from the GitHub Releases page.

Cargo (Rust Package Manager)

If you have a Rust toolchain installed (Rust ≥ 1.80.0), you can install directly from crates.io:

cargo install onetun

Docker

onetun is available as a lightweight Docker image. This is ideal for containerized environments or Kubernetes sidecars.

docker pull aramperes/onetun

See the Docker usage guide for run commands.

Building from Source

To build from source, you will need git and cargo installed.

git clone https://github.com/aramperes/onetun
cd onetun

# Build release binary
cargo build --release

# Binary will be at target/release/onetun
./target/release/onetun --help

Build Dependencies

Based on the project's Dockerfile and CI scripts, ensure you have the following system dependencies if you are building on Linux:

• build-essential (gcc, etc.)
• pkg-config
• libssl-dev (OpenSSL)

On macOS, you may need OpenSSL installed via Homebrew:

brew install openssl@1.1