Before you start
Requirements and what you'll need to install Proxima Gateway
Before you connect your server and click Install, make sure you have each of the following ready. The whole flow takes 30–60 seconds once these are in place.
What you need
A Linux server
- Ubuntu 22.04 or 24.04 on x86_64 (other modern Debian-family distros generally work but aren't officially tested).
- Root SSH access with a password. Key-based SSH support is on the roadmap; for now the dashboard uses the password and stores it encrypted at rest with AES-256-GCM.
- Outbound HTTPS to
geoip.proximagateway.com— the installer pulls the binary and GeoIP databases from there. - Outbound HTTPS to your dashboard's heartbeat URL (so the proxy can check in once a minute).
Inbound firewall rules
If your server's firewall blocks inbound SSH from arbitrary IPs, allow the dashboard's egress IPs first. They're shown to you on the Connect your server card — copy them into your firewall before testing the SSH connection.
You'll also need to open whichever proxy ports you plan to expose
(say, :80, :443, :8080). Do this after install — see
Port configuration.
Login
You'll need an account on the dashboard. If you don't have one, your
admin creates it via Admin → Users → Add User and shares the
username/password with you. Your server is provisioned automatically as
part of that step — you'll see it on /app the moment you log in.
What you don't need
- ❌ A GitHub account or release token (the dashboard handles binary distribution internally).
- ❌ To touch
systemctl,curl, or any package manager — the installer does it all. - ❌ A pre-existing license key. Your admin generates and stores one for you; it's baked into the config the installer writes. You never see or type it.
Ready? → Connect your server