Skip to content

WGDashboard

VPN & Tunnels

Simple dashboard for WireGuard VPN written in Python & Vue.js

Vue Latest v4.3.3 · 1mo ago Security brief →

Features

  • Provides a web UI to view and manage WireGuard configurations
  • Simplifies monitoring by eliminating the need to SSH into servers
  • Supports multiple servers with cross‑server overview

Recent releases

View all 2 releases →
v4.3.3 Breaking risk
⚠ Upgrade required
  • For Python 3.10/3.11 users: remove venv directory in src/, update Python to 3.12+, then run `./wgd.sh install` followed by `./wgd.sh update`
  • Database config now supports environment variables: DATABASE_TYPE, DATABASE_HOST, DATABASE_USERNAME, DATABASE_PASSWORD (Docker)
Breaking changes
  • Python 3.10 and 3.11 support removed; Python 3.12 is now the minimum required version
Notable features
  • AmneziaWG 2.0 support
  • Peer notes and peer tracking toggle
  • Docker: WireGuard/AmneziaWG autostart, OIDC config persistence, database configuration via environment variables
Full changelog

[!WARNING]
All users running WGDashboard v4.2.x or later and hosted on the public internet are strongly advised to update to the latest release immediately.

With this release, a special thank you goes to @0x45dd for discovering the security issue addressed in our previous release.

Please Read Before You Update

Starting from this release and going forward, due to the recent security update, WGDashboard will only support Python 3.12 or above.

If you're using Python 3.10/3.11, you can do the following:

  1. Remove the whole venv directory in WGDashboard's src directory.
  2. Update your python to at least 3.12, and verify with python3 --version
  3. Run ./wgd.sh install
  4. Run ./wgd.sh update

What's New?

  • Added support for AmneziaWG 2.0
  • Added Peer notes

What's Changed?

  • Added Peer Tracking switch
  • Added database table integrity check, adding columns if it doesn’t exist
  • Updated Email module to include IMPLICITTLS for some email provider require TLS from the start of the connection
  • Added toggle to disable/enable peer tracking
  • and many stability improvements...

For Docker Users

  • Added Autostart for WireGuard and AmneziaWG Configurations
  • Adjusted base image version to Alpine v3.23
  • Added persistence for OIDC configuration
  • Added IP address detection
  • Added reading Environment Variables for:
    • Database Type
    • Database Host
    • Database Username
    • Database Password
v4.3.2 Security relevant
Security fixes
  • Critical unauthenticated file system access vulnerability (details in Discord)

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

About

Stars
3,596
Forks
425
Languages
Vue Python JavaScript

Beta — feedback welcome: [email protected]