Documentation
Installation

Installation

One-liner install (recommended)

macOS and Linux

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

Detects your OS and architecture automatically (macOS Apple Silicon, macOS Intel, Linux amd64, Linux arm64). Installs to /usr/local/bin or ~/.local/bin, removes macOS Gatekeeper quarantine, and adds to PATH if needed.

Windows (PowerShell)

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

Detects amd64 or arm64, downloads the binary, unblocks it from Windows SmartScreen, and adds to your user PATH.

After installing, log in and start your first tunnel:

mekong login
mekong 3000

Manual install (Linux & Windows)

Linux — amd64

sudo curl -L https://github.com/MuyleangIng/MekongTunnel/releases/download/v1.5.0/mekong-linux-amd64 -o /usr/local/bin/mekong
sudo chmod +x /usr/local/bin/mekong
mekong 3000

Linux — arm64

sudo curl -L https://github.com/MuyleangIng/MekongTunnel/releases/download/v1.5.0/mekong-linux-arm64 -o /usr/local/bin/mekong
sudo chmod +x /usr/local/bin/mekong
mekong 3000

Windows (manual)

  1. Download mekong-windows-amd64.exe (opens in a new tab) (or arm64)
  2. Rename it to mekong.exe
  3. Move it to a directory in your PATH (e.g. C:\Users\YourName\bin)
  4. Right-click → Properties → check Unblock → click OK
  5. Open a terminal and run mekong 3000
⚠️

Windows SmartScreen may block the file on first run. The PowerShell one-liner (install.ps1) handles this automatically via Unblock-File.

Build from source (Go 1.24+)

go install muyleanging.com/mekongtunnel/cmd/mekong@latest

Upgrading

mekong update

Detects your platform, downloads the latest release, verifies the checksum, and replaces the binary atomically.

Ecosystem

Install once, use everywhere — official packages for Node.js, Python, and VS Code.

Node.js / npmPython / PyPIVS Code Extension

Raw SSH (no install needed)

Skip the CLI entirely and use the ssh command you already have.

# Basic
ssh -t -R 80:localhost:3000 mekongtunnel.dev
 
# With keep-alive (recommended)
ssh -t -R 80:localhost:3000 -o ServerAliveInterval=60 -o ServerAliveCountMax=3 mekongtunnel.dev
 
# With expiry
ssh -o SetEnv=MEKONG_EXPIRE=48h -t -R 80:localhost:3000 mekongtunnel.dev

Replace 3000 with your local port. The -t flag is required, or the server cannot display your tunnel URL.

Verify the install

mekong --help
mekong test
Getting StartedHow It Works