Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
A web-based configuration portal for WireGuard server management. It controls WireGuard interfaces through wgctrl, so peers can be enabled, disabled or given an expiry date without disturbing existing connections, and it shows a QR code and wg-quick config for each client. Sign-in can come from the local database, LDAP, OAuth/OIDC or passkeys, and there is a REST API, Prometheus metrics and support for several interfaces. It manages WireGuard on the local server by default, with MikroTik (beta) and pfSense (alpha) backends, and lists no mesh features. A Go binary with a Vue frontend and SQLite by default.
Runs on a VPS from $4/mo (Kamatera 1GB, 1 GB RAM) · prices checked Nov 2026
Fits home hardware (8 MB measured idle, RAM only): Raspberry Pi 4 (4 GB) (arm64 untested), Raspberry Pi 5 (8 GB) (arm64 untested), Repurposed laptop (8 GB), Intel N100 mini PC (16 GB), AMD Ryzen mini PC (32 GB).
Pick WireGuard Portal when you run a WireGuard server and want a web UI to manage its interfaces and peers, with sign-in from LDAP, OIDC or passkeys. The README describes a web-based configuration portal for WireGuard server management that drives interfaces through wgctrl. It lists QR codes and wg-quick configs for clients, peer expiry, several interfaces, a REST API, Prometheus metrics, and MikroTik (beta) and pfSense (alpha) backends. It manages WireGuard on a server and the README lists no mesh or coordination-server features. It is MIT-licensed Go with a Vue frontend and SQLite by default. Our snippet uses the docs' in-container Docker example rather than the host-network Compose file in the repository: `wgportal/wg-portal:v2.3.1` (released 2026-06-12) with `NET_ADMIN`, ports 8888/tcp and 51820/udp, admin password and web secrets generated into `.env`, and `WG_PORTAL_WEB_EXTERNAL_URL` set to the host's first IP. We did not find an upstream RAM minimum, so our 128 MB floor is an estimate. In the catalog, wg-easy is a web UI for adding and managing clients on a WireGuard server, Headscale is a self-hosted Tailscale control server for a WireGuard mesh with the official Tailscale clients, and NetBird is a WireGuard mesh with SSO; WireGuard Portal sits with wg-easy as a server-side manager. Its README lists multiple interfaces and LDAP and OAuth login, and its docs add OIDC; the wg-easy entry here lists OIDC login, client expiry and Prometheus metrics, but not LDAP or multiple interfaces.
Paid link — we earn a commission if you shop through it.
Run these commands on your server:
# WireGuard Portal: web UI for managing WireGuard interfaces and peers on this server. Adapted from the docs' "within the container" Docker example, image pinned to v2.3.1; admin password and web secrets generated, external URL set to this host's first IP
mkdir wg-portal && cd wg-portal
mkdir data config
cat > .env <<EOF
WG_PORTAL_CORE_ADMIN_USER=admin@wgportal.local
WG_PORTAL_CORE_ADMIN_PASSWORD=$(openssl rand -hex 16)
WG_PORTAL_WEB_SESSION_SECRET=$(openssl rand -hex 32)
WG_PORTAL_WEB_CSRF_SECRET=$(openssl rand -hex 32)
WG_PORTAL_WEB_EXTERNAL_URL=http://$(hostname -I | awk '{print $1}'):8888
EOF
cat > docker-compose.yml <<'EOF'
services:
wg-portal:
image: wgportal/wg-portal:v2.3.1
restart: unless-stopped
env_file: .env
cap_add:
- NET_ADMIN
ports:
- "51820:51820/udp"
- "8888:8888/tcp"
sysctls:
- net.ipv4.conf.all.src_valid_mark=1
volumes:
- ./data:/app/data
- ./config:/app/config
EOF
docker compose up -d
timeout 300 bash -c 'until curl -fsS -o /dev/null http://localhost:8888/app/; do sleep 3; done'
# → http://SERVER_IP:8888 (log in as admin@wgportal.local with the WG_PORTAL_CORE_ADMIN_PASSWORD value from .env, then create a WireGuard interface)WireGuard Portal's README and configuration docs flag these before you rely on it:
WireGuard Portal used 8 MB of RAM at idle on GCP e2-standard-2 · Ubuntu 26.04 LTS · Docker 29.9.3 (first boot, measured Nov 2026). We list a minimum of 128 MB.
The WireGuard Portal install snippet is marked verified on Ubuntu 26.04 (Nov 2026).