Repository navigation
VPN Admin v2.0.0
VPN Admin v2.0.0 is the first stable release of the redesigned provider-based architecture. The project evolves from an AmneziaWG-specific panel into a visual control plane for VPN infrastructure.
Highlights
Visual infrastructure management
- Geographic server map with locations, health statuses, clusters, and tunnels.
- Tunnel visualization with p95 latency over a sliding 15-minute window.
- Interactive Network Graph for connecting interfaces and listeners with directed links.
- Multi-server routes and visual rerouting of existing connections.
Multiple VPN providers
- AmneziaWG / WireGuard, Xray, and Hysteria 2 support.
- Mixed-protocol chains using local route connections between providers on the same host.
- Unified user management across servers and protocols.
- AWG client configurations and Xray/Hysteria 2 connection URIs.
Provider-driven configuration
- Providers expose resource manifests and JSON Schemas.
- Configuration forms are generated dynamically with React JSON Schema Form.
- Cached schemas remain available when a server is temporarily unreachable.
- New providers can be added without protocol-specific forms or deployment logic in the admin core.
Independent deployment
- Pack-based agent and provider deployment.
- Providers install and configure their own cores, dependencies, registrations, and firewall rules.
- Public and private OCI registries, local binaries, and local directories are supported.
- Agents and providers can be installed, updated, and removed independently.
- The agent supervises provider processes and persists desired resource state.
Migration and reliability
- Existing AWG configurations can be imported with preview.
- Improved cleanup for users, peers, interfaces, links, servers, and remote provider resources.
- Protocol-neutral health checks and detailed resource status reporting.
- Desktop and standalone web server modes share the same model and functionality.
Breaking changes
V2 replaces AWG-specific resource and deployment workflows with provider-managed resources. Some APIs and configuration formats differ from v1.
The v2 database is stored separately at ~/.vpn-admin/db. Migration from v1 is manual and leaves the source database unchanged.
Before upgrading, back up your existing installation and stop both applications. Then run:
awg-migrate v2By default, this migrates ~/.awg-admin to ~/.vpn-admin/db. After migration, review the imported resources and install the v2 agent and required providers through Manage panel → Agent.