A set of bash scripts for installing and managing a WireGuard VPN server.

Go to file

Matthew Saunders Brown 17d7a025e8 fix path to apt conf 10periodic		2022-07-14 08:49:33 -07:00
LICENSE	initial commit	2021-01-25 15:37:53 -08:00
README.md	changed name from wireguard-stack to vpn-stack	2021-03-15 11:03:49 -07:00
wg-client-add.sh	changed name from wireguard-stack to vpn-stack	2021-03-15 11:03:49 -07:00
wg-client-create-zip.sh	changed name from wireguard-stack to vpn-stack	2021-03-15 11:03:49 -07:00
wg-client-del.sh	changed name from wireguard-stack to vpn-stack	2021-03-15 11:03:49 -07:00
wg-client-disable.sh	changed name from wireguard-stack to vpn-stack	2021-03-15 11:03:49 -07:00
wg-client-enable.sh	changed name from wireguard-stack to vpn-stack	2021-03-15 11:03:49 -07:00
wg-client-qr-create-png.sh	changed name from wireguard-stack to vpn-stack	2021-03-15 11:03:49 -07:00
wg-client-qr-display.sh	changed name from wireguard-stack to vpn-stack	2021-03-15 11:03:49 -07:00
wg-cron.sh	changed name from wireguard-stack to vpn-stack	2021-03-15 11:03:49 -07:00
wg-install.sh	fix path to apt conf 10periodic	2022-07-14 08:49:33 -07:00
wg-peer-audit.sh	changed name from wireguard-stack to vpn-stack	2021-03-15 11:03:49 -07:00

README.md

vpn-stack

A set of bash scripts for installing and managing a WireGuard VPN server.

Download & Install

Start with basic Ubuntu 20.04 install with no extra services or packages installed.

cd /usr/local/src/
wget https://git.stack-source.com/stackaas/stack-vpn/archive/master.tar.gz
tar zxvf master.tar.gz
cd stack-vpn
chmod 750 wg-*.sh
mv wg-*.sh /usr/local/sbin/
/usr/local/sbin/wg-install.sh

Configure Clients

Download and install client software from wireguard.com.

Add a client configuration to the server and display a qr code that can be scanned by a client.

wg-client-add.sh username [device]
wg-client-qr-display.sh username [device]

If the device option is left off then a "default" device will be added for that client/username. For example, to add a client config for a user named joe and display the qr code on the console screen run:

wg-client-add.sh joe
wg-client-qr-display.sh joe

Todo

Complete documentation that describes in detail the configuration of the WireGuard server coming next. In the meantime review the comments in wg-install.sh to see details.