PRODUCTION INSTALLATION & DEPLOYMENT

Deploy Hackergate across bare-metal Linux servers, edge virtual machines, and container clusters. Engineered in 100% pure Go with zero CGO dependencies.

Method A: Automated One-Line Shell Installer

The automated installer detects system architecture (x86_64, aarch64), validates GLIBC/musl compatibility, installs the static binary to /usr/local/bin/hg, creates default config directories in /etc/hackergate/, sets up systemd service units, and starts the gateway.

AUTOMATED PRODUCTION INSTALLER
$ curl -fsSL https://hackergate.hu/install.sh | bash

Method B: Native Linux Packages (DEB / RPM)

Official Debian/Ubuntu (.deb) and Red Hat/CentOS/Fedora (.rpm) packages include system user creation (hackergate:hackergate), logrotate configuration, and unprivileged capability binding.

Debian / Ubuntu

# Download and install latest .deb: curl -LO https://hackergate.hu/releases/hackergate_latest_amd64.deb sudo dpkg -i hackergate_latest_amd64.deb sudo apt-get install -f # resolve dependencies

RHEL / Rocky / Fedora

# Download and install latest .rpm: curl -LO https://hackergate.hu/releases/hackergate_latest_x86_64.rpm sudo rpm -ivh hackergate_latest_x86_64.rpm

Method C: Systemd Service & Non-Root Capabilities

Hackergate should run as an unprivileged service. Grant CAP_NET_BIND_SERVICE to bind privileged ports 80 and 443 without root permissions:

/etc/systemd/system/hackergate.service
[Unit] Description=Hackergate Next-Era Autonomous Edge Reverse Proxy & WAF Documentation=https://hackergate.hu/docs After=network.target network-online.target Wants=network-online.target [Service] Type=simple User=hackergate Group=hackergate ExecStart=/usr/local/bin/hg gateway run --config /etc/hackergate/gateway.toml ExecReload=/bin/kill -HUP $MAINPID Restart=always RestartSec=3s LimitNOFILE=1048576 # Linux Hardening & Zero Privilege Elevation AmbientCapabilities=CAP_NET_BIND_SERVICE CapabilityBoundingSet=CAP_NET_BIND_SERVICE ProtectSystem=strict ReadWritePaths=/run/hackergate /var/log/hackergate /etc/hackergate ProtectHome=true PrivateTmp=true NoNewPrivileges=true [Install] WantedBy=multi-user.target
# Reload systemd and start Hackergate service: sudo systemctl daemon-reload sudo systemctl enable --now hackergate sudo systemctl status hackergate

Method D: Docker & Podman Container Deployment

Official minimal OCI container images are published on the Hackergate Registry (repo.pilab.hu/hackergate).

docker-compose.yaml
version: '3.8' services: hackergate: image: repo.pilab.hu/hackergate:latest container_name: hackergate-edge restart: always network_mode: host volumes: - /etc/hackergate:/etc/hackergate:ro - /var/log/hackergate:/var/log/hackergate:rw - /var/lib/hackergate/acme:/var/lib/hackergate/acme:rw environment: - HACKERGATE_LOG_LEVEL=info cap_add: - NET_BIND_SERVICE
← BACK TO DOCS HUBNEXT: VHOSTS & ROUTING SPECIFICATION →