Install gotunnel

Choose your preferred installation method for your operating system

🍎 macOS Installation

Homebrew (Recommended)

The easiest way to install gotunnel on macOS

brew tap v1truv1us/gotunnel
brew install gotunnel

Install Script

Direct installation using our install script

curl -sSL https://raw.githubusercontent.com/v1truv1us/gotunnel/main/scripts/install.sh | bash

Go Install

If you have Go installed

go install github.com/v1truv1us/gotunnel/cmd/gotunnel@latest

🐧 Linux Installation

APT (Debian/Ubuntu)

For Debian-based distributions

curl -fsSL https://github.com/v1truv1us/gotunnel/releases/latest/download/gotunnel_0.1.0-beta_amd64.deb -o gotunnel.deb
sudo dpkg -i gotunnel.deb

AUR (Arch Linux)

For Arch Linux users

yay -S gotunnel
# or: paru -S gotunnel

Install Script

Universal installation script for Linux

curl -sSL https://raw.githubusercontent.com/v1truv1us/gotunnel/main/scripts/install.sh | bash

🪟 Windows Installation

Scoop (Recommended)

Easy package management for Windows

scoop bucket add v1truv1us https://github.com/v1truv1us/scoop-bucket
scoop install gotunnel

Winget

Windows Package Manager

winget install v1truv1us.gotunnel

Chocolatey

Popular Windows package manager

choco install gotunnel

🐳 Docker Installation

Docker Run

Quick start with Docker

docker run --rm -p 8080:8080 -p 8443:8443 ghcr.io/v1truv1us/gotunnel:latest

Docker Compose

Production deployment with Docker Compose

version: '3.8'
services:
  gotunnel:
    image: ghcr.io/v1truv1us/gotunnel:latest
    ports:
      - "8080:8080"
      - "8443:8443"
    environment:
      - ENVIRONMENT=production
    restart: unless-stopped

✅ Verify Installation

After installation, verify that gotunnel is working correctly:

Check Version

gotunnel --version

Quick Test

Start a simple tunnel (no root privileges required):

gotunnel start -p 3000 -d test

# Access at https://test.localhost:8443