Skip to content
HubProxyHubProxy

System Installation

Install Script

Section titled “Install Script”
Terminal window
curl -fsSL https://raw.githubusercontent.com/sky22333/hubproxy/main/install.sh | sh

Supports amd64 / arm64 with apt, dnf, apk, and other package managers.

File Paths

Section titled “File Paths”
Path Description
/etc/hubproxy/config.toml Configuration file
/usr/bin/hubproxy Binary
/lib/systemd/system/hubproxy.service systemd unit (Debian/Ubuntu/RHEL)
/etc/init.d/hubproxy OpenRC service (Alpine)
/var/log/hubproxy.log Alpine log file

systemd

Section titled “systemd”
Terminal window
sudo systemctl status hubproxy    # Check service status
sudo systemctl restart hubproxy   # Restart after config changes
sudo journalctl -u hubproxy -f    # Follow logs
sudo nano /etc/hubproxy/config.toml  # Edit config

Uninstall:

Terminal window
sudo apt purge hubproxy   # Debian/Ubuntu — remove package and config

OpenRC (Alpine)

Section titled “OpenRC (Alpine)”
Terminal window
sudo rc-service hubproxy status   # Check status
sudo rc-service hubproxy restart  # Restart service
sudo tail -f /var/log/hubproxy.log  # Follow logs
sudo vi /etc/hubproxy/config.toml   # Edit config

Uninstall:

Terminal window
sudo apk del hubproxy   # Remove package

Production recommendation

Section titled “Production recommendation”

For public or team use, point a custom domain at HubProxy through Caddy / Nginx with HTTPS enabled, instead of exposing http://IP:5000 long term. This provides TLS, correct client IP forwarding, and safer access. See Reverse Proxy and Recommended Architecture.