Installation

Prerequisites

• OS: Ubuntu 22.04 LTS (Debian 12 also works).
• Hardware: 4 vCPU / 8 GB RAM / 100 GB SSD minimum. 32 vCPU / 32 GB / NVMe for 25k+ subscribers.
• Network: Public IPv4 with TCP 80, 443 and UDP 1812, 1813, 3799 reachable.
• License key from your distributor.

Caution

Must be a physical server or VM (KVM / VMware / Hyper-V). LXC containers are not supported — metrics from /proc reflect the host, not the container.

One-command install

curl -sL https://license.proxrad.com/install | bash -s -- YOUR_LICENSE_KEY

The installer will:

1. Install Docker + Docker Compose if missing.
2. Generate a .env with strong random secrets.
3. Detect your public IP via api.ipify.org.
4. Capture + so the hardware ID stays stable across restarts.
5. Optionally create a LUKS-encrypted data volume.
6. Pull the latest signed binaries from the license server.
7. Start all 5 containers: proxpanel-db, proxpanel-redis, proxpanel-api, proxpanel-radius, proxpanel-frontend.
8. Configure nginx with a self-signed certificate (replace with Let’s Encrypt later).

Expected runtime: 3-5 minutes on a clean server.

After install

✓ Install complete.

Admin panel:  https://<your-server-ip>/
Username:     admin
Password:     <24-char generated string — copy this NOW>

Next: First-Run Checklist.

Common install issues

“SERVER_IP must be a real public IP” — detected a private IP. Set manually:

echo "SERVER_IP=YOUR_PUBLIC_IP" >> /opt/proxpanel/.env
cd /opt/proxpanel && docker compose up -d

Hardware ID mismatch on re-install — VM clone or disk change. Contact support to re-bind the license.

“Port 80 / 443 already in use” — stop the conflicting service (systemctl stop apache2) or change ProxPanel ports in docker-compose.yml.