8bd9b6192e
Docker / Build and Push (push) Canceled after 0s
github-pages / deploy (push) Canceled after 0s
Test / make test (push) Canceled after 0s
Docker / release (push) Canceled after 0s
Feat/client side key generation (#764)
* feat: expose editable key capability to frontend

Signed-off-by: I.F. <131729144+FukumotoIkuma@users.noreply.github.com>

* feat: expose editable keys setting

Signed-off-by: I.F. <131729144+FukumotoIkuma@users.noreply.github.com>

* feat: add browser WireGuard key and config helpers

Signed-off-by: I.F. <131729144+FukumotoIkuma@users.noreply.github.com>

* feat: support browser-only key generation for self provisioning

Signed-off-by: I.F. <131729144+FukumotoIkuma@users.noreply.github.com>

* fix: hide server config actions without private key

Signed-off-by: I.F. <131729144+FukumotoIkuma@users.noreply.github.com>

* refactor: share browser WireGuard key helpers

Signed-off-by: I.F. <131729144+FukumotoIkuma@users.noreply.github.com>

* refactor: reuse WireGuard browser key helpers

Signed-off-by: I.F. <131729144+FukumotoIkuma@users.noreply.github.com>

* fix: address review feedback for client-side key generation

- Make generated key fields read-only so the downloaded config always matches the registered public key
- Drop unreachable error handling and defensive branches; mirror wg_peer.tpl in the config builder
- Keep only the keypair helper shared with KeyGeneraterView
- Restore trailing newlines and remove the duplicated help text
- Document browser-side key generation and add EditableKeys to the v0 swagger spec

Signed-off-by: I.F. <131729144+FukumotoIkuma@users.noreply.github.com>

* test: cover EditableKeys setting and browser-generated peer keys

Signed-off-by: I.F. <131729144+FukumotoIkuma@users.noreply.github.com>

* improve ui, fix potential race condition

---------

Signed-off-by: I.F. <131729144+FukumotoIkuma@users.noreply.github.com>
Co-authored-by: Christoph <christoph.h@sprinternet.at>
2026-11-09 22:47:38 +01:00
2026-01-05 23:25:37 +01:00
2024-09-23 21:54:22 +02:00
2024-07-04 22:37:30 +02:00
2026-09-12 17:52:01 +02:00
2026-11-09 19:38:52 +01:00
2026-11-09 19:38:52 +01:00
2025-10-04 14:17:29 +02:00
2026-09-12 17:52:01 +02:00
2025-12-09 22:33:12 +01:00
2025-10-04 14:17:29 +02:00

WireGuard Portal v2

Build Status License: MIT GitHub last commit Go Report Card GitHub go.mod Go version GitHub code size in bytes Docker Pulls

Introduction

WireGuard Portal is a simple, web-based configuration portal for WireGuard server management. The portal uses the WireGuard wgctrl library to manage existing VPN interfaces. This allows for the seamless activation or deactivation of new users without disturbing existing VPN connections.

The configuration portal supports using a database (SQLite, MySQL, MsSQL, or Postgres), OAuth or LDAP (Active Directory or OpenLDAP) as a user source for authentication and profile data.

Features

  • Self-hosted - the whole application is a single binary
  • Responsive multi-language web UI with dark-mode written in Vue.js
  • Automatically selects IP from the network pool assigned to the client
  • QR-Code for convenient mobile client configuration
  • Sends email to the client with QR-code and client config
  • Enable / Disable clients seamlessly
  • Generation of wg-quick configuration file (wgX.conf) if required
  • User authentication (database, OAuth, or LDAP), Passkey support
  • IPv6 ready
  • Docker ready
  • Can be used with existing WireGuard setups
  • Support for multiple WireGuard interfaces
  • Supports multiple WireGuard backends (wgctrl, MikroTik, or pfSense)
  • Peer Expiry Feature
  • Handles route and DNS settings like wg-quick does
  • Exposes Prometheus metrics for monitoring and alerting
  • REST API for management and client deployment
  • Webhook for custom actions on peer, interface, or user updates

Screenshot

Documentation

For the complete documentation visit wgportal.org.

What is out of scope

  • Automatic generation or application of any iptables or nftables rules.
  • Support for operating systems other than linux.
  • Automatic import of private keys of an existing WireGuard setup.

Application stack

License

Contributors and Sponsors

Thanks so much for all your contributions! They’re truly appreciated and help keep WireGuard Portal moving ahead.

Want to support the project? You can buy me a coffee or join as a contributor - every bit of support helps! Become a sponsor!

Important

Since the project was accepted by the Docker-Sponsored Open Source Program, the Docker image location has moved to wgportal/wg-portal. Please update the Docker image from h44z/wg-portal to wgportal/wg-portal.

S
Description
WireGuard Configuration Portal with LDAP connection
Readme
23 MiB
Languages
Go 77.5%
Vue 13.5%
JavaScript 5.2%
Go Template 3.1%
Makefile 0.3%
Other 0.3%