Skip to main content
Gate is distributed as a single executable with no Java required. Choose your preferred installation method below.

​
Quick Install

The easiest way to install Gate is using our automated installation scripts: 
curl -fsSL https://gate.minekube.com/install | bash
The installation script will:
  • Detect your system architecture automatically
  • Download the latest Gate release
  • Verify the binary with SHA256 checksum
  • Install to your user directory (no admin/root required)
  • Provide instructions to add Gate to your PATH

​
Installation Output

✨ Installing Gate...
⚡ Downloading Gate 0.42.2 for darwin-arm64...
✅ Checksum verified for gate_0.42.2_darwin_arm64
✨ Successfully installed Gate 0.42.2!
📍 Location: /Users/robin/.local/bin/gate
🚀 Run gate to start the proxy

​
Manual Installation

If you prefer to download and install Gate manually:
1

Download the binary

Visit the GitHub Releases page and download the appropriate binary for your system:
  • Linux AMD64: gate_*_linux_amd64
  • Linux ARM64: gate_*_linux_arm64
  • macOS Intel: gate_*_darwin_amd64
  • macOS Apple Silicon: gate_*_darwin_arm64
  • Windows AMD64: gate_*_windows_amd64.exe
  • Windows ARM64: gate_*_windows_arm64.exe
2

Verify the checksum (recommended)

Download the corresponding .sha256 file and verify:
Linux/macOS
sha256sum -c gate_*_sha256.txt
Windows
CertUtil -hashfile gate.exe SHA256
3

Make executable and move to PATH

chmod +x gate*
mkdir -p ~/.local/bin
mv gate* ~/.local/bin/gate
4

Add to PATH

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
5

Verify installation

gate --version

​
Installation Locations

The installation scripts use the following default locations:
  • Linux/macOS: ~/.local/bin/gate
  • Windows: %LOCALAPPDATA%\Gate\bin\gate.exe
Both locations are in user space and don’t require administrative privileges.

​
Running Gate

After installation, start Gate with: 
gate
Gate will create a default config.yml file in the current directory if one doesn’t exist. See the Configuration guide for customization options.

​
Updating Gate

To update to the latest version, simply run the installation script again or manually download the new binary.

​
Uninstalling

To remove Gate, delete the binary: 
rm ~/.local/bin/gate

​
Troubleshooting

The binary is installed but not in your PATH. Either:
  • Add the installation directory to your PATH (see Step 4 above)
  • Run Gate using the full path: ~/.local/bin/gate or $env:LOCALAPPDATA\Gate\bin\gate.exe
On Linux/macOS, ensure the binary is executable:
chmod +x ~/.local/bin/gate
This security check ensures the downloaded binary matches the official release:
  • Try downloading again (file may have been corrupted)
  • If the issue persists, report it on GitHub Issues
Try manual installation instead, or check:
  • Internet connectivity
  • Write permissions to installation directory
  • Available disk space

​
Security

Our installation process prioritizes security:
  • User space installation: No system-wide changes or root/admin required
  • Checksum verification: All binaries verified with SHA256
  • Official sources only: Downloads from GitHub releases exclusively
  • Open source scripts: Review install script and install.ps1
  • No data collection: Scripts don’t collect or transmit any data

​
Next Steps

Configuration

Configure Gate for your network

Quick Start

Get your proxy running in minutes

Build docs developers (and LLMs) love

Get started for freeTalk to us