Menu

Installation

The tnnl CLI installs with a single command. The installer downloads the right prebuilt binary for your OS and architecture, verifies its sha256 checksum, and puts it on your PATH.

macOS and Linux

Run the install script in your terminal:

$ curl -fsSL https://tnnl.uz/install.sh | sh

The binary is installed to /usr/local/bin, falling back to ~/.local/binwhen that location isn't writable.

Windows

Run the install command in PowerShell:

irm https://tnnl.uz/install.ps1 | iex

The binary is installed to %LOCALAPPDATA%\Programs\tnnl and that directory is added to your PATH.

Supported platforms

  • macOS (Apple Silicon and Intel)
  • Linux x86_64
  • Windows x86_64

Verify the install

Confirm the CLI is on your path and check its version:

$ tnnl --version

Updating

Update to the latest release at any time:

$ tnnl upgrade

The CLI also prints a one-line notice on startup when a newer version is available. To disable that check, set TNNL_NO_UPDATE_CHECK=1 in your environment.

Install environment overrides

The installer reads a few environment variables, which is useful for pinning a version or installing from a mirror:

VariableEffect
TNNL_INSTALL_DIROverride the install location.
TNNL_VERSIONInstall a specific version instead of the latest.
TNNL_BASE_URLDownload from a mirror or self-hosted base URL.

Next step

With the CLI installed, head to the Quickstart to log in and open your first tunnel.