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

Go to file

Matthew Saunders Brown b10050cf16 make base-stack a requirement, update syntax of error messages to become proper sentences		2024-07-24 14:59:14 -07:00
sbin	Switch from Ubuntu to Debian compatibility with signifant reworking of code and installer.	2024-07-24 14:00:18 -07:00
systemd	Switch from Ubuntu to Debian compatibility with signifant reworking of code and installer.	2024-07-24 14:00:18 -07:00
COPYING	include GPL 3 COPYING file	2022-07-14 12:35:44 -07:00
install.sh	make base-stack a requirement, update syntax of error messages to become proper sentences	2024-07-24 14:59:14 -07:00
README.md	make base-stack a requirement, update syntax of error messages to become proper sentences	2024-07-24 14:59:14 -07:00

README.md

vpn-stack

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

Requirements

A minimal Debian 12 server install with no extra services or packages installed. Requires base-stack which will configure a basic server set up including firewald & fail2ban to secure the server: https://git.stack-source.com/msb/base-stack

Install

cd /usr/local/src/
git clone https://git.stack-source.com/msb/vpn-stack.git
cd vpn-stack
bash install.sh

Configure Clients

Download and install client software from wireguard.com.

Add a client configuration to the server, display a qr code that can be scanned by a client, and email a zipped copy of the config.

wg-client-add.sh -c <client>
wg-client-qr-display.sh -c <client>
wg-client-zip-email.sh -c <client> -e <email>

For example, to add a client config for a user named joe, display the qr code on the console screen, and then email a zipped copy of the config run:

wg-client-add.sh -c joe
wg-client-qr-display.sh -c joe
wg-client-zip-email.sh -c joe -e joe@example.com

License

Copyright (c) 2024 Matthew Saunders Brown matthewsaundersbrown@gmail.com
GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)