I just wanted access to my PiHole on my mobile when out of the house so I could get the tracking benefits when out of the house. I was surprised to find Wireguard was relatively simple to set up configure and deploy for my small use case of a desktop, Raspberry Pi, Mobile, iPad, and laptop.
I did run into a small issue with a typo in my config file, which took me an hour to spot, even after I’d spotted it in the script I created to automate adding peers.
First thing is some basic set up and admin, install wireguard (and the ufw firewall as I am using a Raspberry Pi) and a QR code generation tool I’ll use later for adding mobile devices:
sudo apt install wireguard wireguard-tools ufw qrencode -y
First hing is to configure the firewall, so the necessary ports ready to go and the Pi is protected:
sudo ufw allow 22/any # ssh
sudo ufw allow 53/any # pihole dns
sudo ufw allow 80/tcp # pihole
sudo ufw allow 4711/tcp # pihole
sudo ufw allow 47777/ # wireguard port
I discovered after much troubleshooting that I was using the wrong firewall rules within my configuration file as I was not using IPtables that the rules were deigned to forward traffic between the wireguard network and my specified network. I discover tat I needed to add a
UFW route rule, which allows the server to now pass traffic to my non Wireguard devices on the home network:
sudo ufw route allow in on wg0 to 192.168.0.0/24
Then I enabled the firewall with:
sudo ufw enable
It should return
Firewall is active and enabled on system startup.
Next to enable IPv4 forwarding so we can access the local network via wireguard, need to uncomment a couple of lines in
net.ipv4.ip_forward = 1
net.ipv6.conf.all.forwarding = 1
Check it’s working by running
sudo sysctl -p, it should return the above lines that were uncommented.
I changed the interface setting son the Pi-Hole to be bound to eth0, so it will listen for DNS from devices connected through Wireguard outside of the home network, it’s on the DNS settings page.
Now to move onto the fun part and setup Wireguard.
As the wireguard directory is root privilege only, we’ll jump into a root shell and set up the server:
sudo su -
Next I generated a public private key pair and created the server configuration file.
Generate the public private key pair:
wg genkey | tee server.key | wg pubkey > server.pub
Create the config file and add some basic config to it:
Add the following, the IP address can be whatever you want it to be, I’ve used the 10.x.x.x ranges as my static network is on the 192.x.x.x range, of course IPv6 is optional. The port is also anything you’d like in the higher range that your not already using:
Then append the previously generated private key to the config file:
echo "PrivateKey = $(cat server.key)" >> /etc/wireguard/wg0.conf
And exit from your sudo session, that’s the basic server setup. Now it’s time to register and start the server. Run these three commands to register the server as
wg0 and start it:
sudo systemctl enable [email protected]
sudo systemctl daemon-reload
sudo systemctl start wg-quick@wg0
sudo wgto see if the server is running, you should have returned:
The following commands will now enable and disable Wireguard, I found it is required to bring the interface down and up after adding a client:
sudo wg-quick up wg0
sudo wg-quick down wg0
Next is to set up your peers, to do this I created as script as it’s a lot of easy to mess up commands and editing config files, so automating it seemed like the approach least likely to fail. It also generates QR code to easily add mobile devices. You can find my script on Github here.
I installed the apps and scanned the QR code to add the configuration to them. Enable the interface and I had issues, but I found it was all to do with typo’s in my script. Once they were eradicated I had a working virtual network, that keeps me connected wherever I am.
To test your connections is working
sudo wg showwill show all connected peers, a peer looks like this:
This was a great learning experience, these instructions were pulled from various sources including Pi-Hole documentation, reddit and stack overflow. I knew almost nothing about Wireguard before this, but now understand how it works and the general bugs that crop up.