Binary Installation

Work in Progress

This page is still being improved. Some details may not be fully accurate — please refer to the actual behavior when in doubt.

Install Frpc-Hub using pre-compiled binaries — ideal for running directly on a server or local machine.

Download

Go to the GitHub Releases page and download the package for your platform:

OS	Architecture	Filename
Linux	x86_64 (amd64)	frpc-hub-linux-amd64.tar.gz
Linux	ARM64	frpc-hub-linux-arm64.tar.gz
Linux	ARMv7	frpc-hub-linux-armv7.tar.gz
macOS	Intel	frpc-hub-darwin-amd64.tar.gz
macOS	Apple Silicon	frpc-hub-darwin-arm64.tar.gz
Windows	x86_64	frpc-hub-windows-amd64.zip

Or download directly from the command line (Linux amd64 example):

curl -LO https://github.com/luckjiawei/frpc-hub/releases/latest/download/frpc-hub-linux-amd64.tar.gz

Install

Linux / macOS

# Extract
tar -xzf frpc-hub-linux-amd64.tar.gz

# Move to system path (optional)
sudo mv frpc-hub /usr/local/bin/

# Make executable
sudo chmod +x /usr/local/bin/frpc-hub

# Verify installation
frpc-hub --version

Windows

Extract the .zip file to any directory, then open PowerShell or Command Prompt inside that directory to use it.

Start

frpc-hub serve --http 0.0.0.0:8090

After starting, visit http://localhost:8090 for the main interface and http://localhost:8090/_/ for the admin panel.

TIP

On first launch, the database is initialized automatically. Data is stored in a pb_data/ folder in the current working directory. Fix the working directory to avoid data scatter.

Auto-start on Boot (Linux)

Use systemd to manage the Frpc-Hub process.

1. Create a dedicated user (optional but recommended)

sudo useradd -r -s /bin/false frpchub

2. Create the data directory

sudo mkdir -p /var/lib/frpc-hub
sudo chown frpchub:frpchub /var/lib/frpc-hub

3. Create the systemd service file

sudo tee /etc/systemd/system/frpc-hub.service > /dev/null <<EOF
[Unit]
Description=Frpc-Hub Service
After=network.target

[Service]
Type=simple
User=frpchub
WorkingDirectory=/var/lib/frpc-hub
ExecStart=/usr/local/bin/frpc-hub serve --http 0.0.0.0:8090
Restart=on-failure
RestartSec=5s

[Install]
WantedBy=multi-user.target
EOF

4. Enable and start the service

sudo systemctl daemon-reload
sudo systemctl enable frpc-hub
sudo systemctl start frpc-hub

# Check status
sudo systemctl status frpc-hub

View Logs

sudo journalctl -u frpc-hub -f

Next Steps

• Binary Upgrade — Upgrade to a new version
• Getting Started — Add servers and proxies