Skip to main content

WGKeeper Documentation

Centralized management for VPN infrastructure

An open-source system for managing WireGuard® infrastructure at scale — a central Console for orchestration paired with Node services running on each server.

Quick startGitHub

AGPL-3.0Self-hostedDocker-ready

What you can manage

Node health and capacity

Track node status, version, peer capacity, and health from one Console view.

Peer management

Create peers, inspect connection state, and verify handshakes after clients connect.

Config generation

Generate WireGuard client configs after assigning peers to the right node.

Metrics & monitoring

Optional Prometheus endpoint per node, with a ready-made Grafana dashboard.

Start operating

Follow the deployment path

Three steps to a working setup. Each step links to the detailed guide.

  1. Install the Console

    Spin up the central control plane with Docker Compose.

    Read the guide

  2. Connect a Node

    Run the Node service and link it from the Console with its API endpoint and key.

    Read the guide

  3. Create peers

    Allocate IPs, generate WireGuard client configs, and monitor handshakes.

    Read the guide