Install

The justtunnel CLI is a single static binary. Pick the install method for your OS — they all land you at the same place.

macOS — Homebrew (recommended)

brew install justtunnel/tap/justtunnel

This taps justtunnel/tap and installs the latest release. Future upgrades flow through brew upgrade.

macOS & Linux — install script

curl -fsSL https://justtunnel.dev/install | sh

The script detects your platform (darwin/linux, arm64/amd64), downloads the matching release tarball from GitHub, and drops justtunnel into a directory on your PATH.

Windows — PowerShell

irm https://justtunnel.dev/install.ps1 | iex

Installs to $env:LOCALAPPDATA\justtunnel\ and adds that directory to your user PATH. You may need to open a new PowerShell window for the PATH change to take effect.

Build from source

If you have Go 1.24+ installed and want to build from main:

go install github.com/justtunnel/justtunnel-cli@latest

The binary lands in $(go env GOPATH)/bin/justtunnel. Make sure that directory is on your PATH.

Verify the install

Run justtunnel version to confirm the binary is on your PATH and report which build you have:

justtunnel version

You should see three lines:

justtunnel 0.4.2
  commit: a1b2c3d
  built:  2026-05-01T12:00:00Z

If you get command not found, the binary isn't on your PATH. Re-open your terminal (so shell init files re-run) or check the install script's output for the directory it used.

Next

Authenticate the CLI against your JustTunnel account: Authenticate →