WGDashboard Documentation Help

🛠 Install

Commands to install WGDashboard

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

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 and 24.02 LTS

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

40, 39 and 38

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 && \ firewall-cmd --add-port=10086/tcp --permanent && \ firewall-cmd --add-port=51820/udp --permanent && \ firewall-cmd --reload

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 -b v4.0-alpine-linux 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

Manually install WGDashboard

  1. Download WGDashboard

    git clone https://github.com/donaldzou/WGDashboard.git
  2. Open the WGDashboard folder

    cd WGDashboard/src
  3. Install WGDashboard

    sudo chmod u+x wgd.sh && \ sudo ./wgd.sh install
  4. 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
  5. Run WGDashboard

    sudo ./wgd.sh start
  6. 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.

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!

DigitalOcean Referral Badge

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: 12 November 2024