🛠 Install

There are 4 options to install WGDashboard

Option 1: Host WGDashboard & WireGuard with DigitalOcean

WGDashboard is now available as a 1-Click app on DigitalOcean! Follow this instruction to host

Option 2: Install WGDashboard with a command

These commands are tested by myself in each operating system listed below. It contains commands to install WireGuard, Git, Net Tools, and even Python on some OS.

Operating System	Version(s)
Ubuntu	20.04 (LTS), 22.04 (LTS), 24.04 (LTS), 24.10
Debian	12.6, 11.10
Red Hat Enterprise Linux (RHEL)	9.4
CentOS	9-Stream
AlmaLinux	9.4 (Seafoam Ocelot)
Fedora	38, 39, 40, 41
Alpine Linux	3.20.2
Rocky Linux	9.4
Raspberry Pi OS	Kernel Version: 6.6 w/ Debian 12 (Bookworm)

20.04 (LTS)

             sudo add-apt-repository ppa:deadsnakes/ppa -y && \
             sudo apt-get update -y && \
             sudo apt-get install python3.10 python3.10-distutils wireguard-tools net-tools --no-install-recommends -y && \
             git clone https://github.com/donaldzou/WGDashboard.git && \
             cd WGDashboard/src && \
             chmod +x ./wgd.sh && \
             ./wgd.sh install && \
             sudo echo "net.ipv4.ip_forward=1" >> /etc/sysctl.conf && \
             sudo sysctl -p
         

22.04 (LTS), 24.04 (LTS) and 24.10

             sudo apt-get update -y && \
             sudo apt install wireguard-tools net-tools --no-install-recommends -y && \
             git clone https://github.com/donaldzou/WGDashboard.git && \
             cd ./WGDashboard/src && \
             chmod +x ./wgd.sh && \
             ./wgd.sh install && \
             sudo echo "net.ipv4.ip_forward=1" >> /etc/sysctl.conf && \
             sudo sysctl -p /etc/sysctl.conf
         

12.6

             apt-get install sudo git iptables -y && \ 
             sudo apt-get update && \
             sudo apt install wireguard-tools net-tools && \
             git clone https://github.com/donaldzou/WGDashboard.git && \
             cd ./WGDashboard/src && \
             chmod +x ./wgd.sh && \
             ./wgd.sh install && \
             sudo echo "net.ipv4.ip_forward=1" >> /etc/sysctl.conf && \
             sudo sysctl -p /etc/sysctl.conf
         

11.10

             apt-get install sudo -y && \ 
             sudo apt-get update && \ 
             sudo apt install -y git iptables build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev libsqlite3-dev wget libbz2-dev wireguard-tools net-tools && \ 
             wget https://www.python.org/ftp/python/3.10.0/Python-3.10.0.tgz && \ 
             tar -xvf Python-3.10.0.tgz && \ 
             cd Python-3.10.0 && \ 
             sudo ./configure --enable-optimizations && \ 
             sudo make && \ 
             sudo make altinstall && \ 
             cd .. && \ 
             git clone https://github.com/donaldzou/WGDashboard.git && \ 
             cd ./WGDashboard/src && \ 
             chmod +x ./wgd.sh && \ 
             ./wgd.sh install && \ 
             sudo echo "net.ipv4.ip_forward=1" >> /etc/sysctl.conf && \
             sudo sysctl -p /etc/sysctl.conf
         

9.4

             sudo yum install wireguard-tools net-tools git python3.11 -y && \
             git clone https://github.com/donaldzou/WGDashboard.git && \
             cd ./WGDashboard/src && \
             chmod +x ./wgd.sh && \
             ./wgd.sh install && \
             sudo echo "net.ipv4.ip_forward=1" >> /etc/sysctl.conf && \
             sudo sysctl -p /etc/sysctl.conf && \
             firewall-cmd --add-port=10086/tcp --permanent && \
             firewall-cmd --add-port=51820/udp --permanent && \
             firewall-cmd --reload
         

9-Stream

             sudo yum install wireguard-tools net-tools git python3.11 -y && \
             git clone https://github.com/donaldzou/WGDashboard.git && \
             cd ./WGDashboard/src && \
             chmod +x ./wgd.sh && \
             ./wgd.sh install && \
             sudo echo "net.ipv4.ip_forward=1" >> /etc/sysctl.conf && \
             sudo sysctl -p /etc/sysctl.conf && \
             firewall-cmd --add-port=10086/tcp --permanent && \
             firewall-cmd --add-port=51820/udp --permanent && \
             firewall-cmd --reload
         

9.4 (Seafoam Ocelot)

                sudo yum install wireguard-tools net-tools git python3.11 -y && \
                git clone https://github.com/donaldzou/WGDashboard.git && \
                cd ./WGDashboard/src && \
                chmod +x ./wgd.sh && \
                ./wgd.sh install && \
                sudo echo "net.ipv4.ip_forward=1" >> /etc/sysctl.conf && \
                sudo sysctl -p /etc/sysctl.conf && \
                firewall-cmd --add-port=10086/tcp --permanent && \
                firewall-cmd --add-port=51820/udp --permanent && \
                firewall-cmd --reload
            

38, 39, 40, 41

             sudo yum install wireguard-tools net-tools git -y && \
             git clone https://github.com/donaldzou/WGDashboard.git && \
             cd ./WGDashboard/src && \
             chmod +x ./wgd.sh && \
             ./wgd.sh install && \
             sudo echo "net.ipv4.ip_forward=1" >> /etc/sysctl.conf && \
             sudo sysctl -p /etc/sysctl.conf
         

3.20.2

               setup-interfaces -a ; \
               rc-service networking --quiet start ; \
               apk update ; \
               apk add wireguard-tools python3 python3-dev git iptables net-tools gcc musl-dev linux-headers sudo ; \
               git clone https://github.com/donaldzou/WGDashboard.git ; \
               cd ./WGDashboard/src ; \
               chmod +x ./wgd.sh ; \
               ./wgd.sh install
			

9.4

             sudo yum install wireguard-tools net-tools git python3.11 -y && \
             git clone https://github.com/donaldzou/WGDashboard.git && \
             cd ./WGDashboard/src && \
             chmod +x ./wgd.sh && \
             ./wgd.sh install && \
             sudo echo "net.ipv4.ip_forward=1" >> /etc/sysctl.conf && \
             sudo sysctl -p /etc/sysctl.conf && \
             firewall-cmd --add-port=10086/tcp --permanent && \
             firewall-cmd --add-port=51820/udp --permanent && \
             firewall-cmd --reload
         

Kernel Version: 6.6 w/ Debian 12 (Bookworm)

             apt-get install sudo git iptables -y && \ 
             sudo apt-get update && \
             sudo apt install wireguard-tools net-tools && \
             git clone https://github.com/donaldzou/WGDashboard.git && \
             cd ./WGDashboard/src && \
             chmod +x ./wgd.sh && \
             ./wgd.sh install && \
             sudo echo "net.ipv4.ip_forward=1" >> /etc/sysctl.conf && \
             sudo sysctl -p /etc/sysctl.conf
         

Option 3: Install with Proxmox Virtual Environment

Please visit this community script to install.

Option 4: Manually install WGDashboard

Download WGDashboard
git clone https://github.com/donaldzou/WGDashboard.git
Open the WGDashboard folder
cd WGDashboard/src
Install WGDashboard
sudo chmod u+x wgd.sh && \ sudo ./wgd.sh install
Give read and execute permission to root of the WireGuard configuration folder, you can change the path if your configuration files are not stored in /etc/wireguard
sudo chmod -R 755 /etc/wireguard
Run WGDashboard
sudo ./wgd.sh start
Access dashboard
Access your server with port 10086 (e.g. http://your_server_ip:10086), using username admin and password admin. See below how to change port and ip that the dashboard is running with.
Allow traffic forwarding (Optional, but recommend for most users)
sudo echo "net.ipv4.ip_forward=1" >> /etc/sysctl.conf sudo sysctl -p /etc/sysctl.conf

Looking for server to configure WireGuard and WGDashboard?

Click my referral button below and register with DigitalOcean, you will receive a $200 credit for 60-days to your server, and you can support this project too!

How to support?

When you choose to use the link above, and spent $25 after your credits, I will receive $25 in credits towards my servers on this project :) Thanks in advance!

Last modified: 20 March 2025