This tutorial will look at how to set up WireGuard on pfSense.
WireGuard is a VPN tool that’s faster, simpler, and leaner than something like OpenVPN. Where OpenVPN has the benefit of longevity, WireGuard is the newer, faster VPN protocol that many people are looking to try. While we are diving into how to install WireGuard on pfSense in this tutorial, please be aware that this is a newer package and for that reason, you might run into some problems. If you want to ensure that you can always access your local network, please consider setting this up with OpenVPN as well. This way, you are ensuring that you’ll always be able to connect.
Once again, as of the writing of this tutorial, WireGuard is experimental. Though I haven’t personally run into any issues other than what is outlined below, that doesn’t mean that everything will work perfectly for everyone.
The process below did NOT work for me on v2.5.2. I was forced to upgrade to v2.6 to get WireGuard working properly.
- 1. How to Set Up WireGuard on pfSense
- 2. WireGuard Peer Configuration
- 3. Client Device Configuration – How to Set Up WireGuard on pfSense
- 3. Connecting WireGuard Client to pfSense
- 4. Conclusion – How to Set Up WireGuard on pfSense
1. How to Set Up WireGuard on pfSense
When looking at how to set up WireGuard on pfSense, the first thing that we need to do is install the package. Follow the instructions below to install the WireGuard package on pfSense.
1. Open the Package Manager and search for WireGuard, then Install the latest version of the package.
2. After the package has installed, select VPN then WireGuard and under the Tunnels section, select Add Tunnel.
3. In the Tunnel Configuration, set the Description as WireGuard, the Listen Port as 51820, then Generate private and public keys.
4. Copy the Public Key. We will need this for our client configuration.
5. Create the tunnel, then select Settings, and ensure that Enable WireGuard is selected. Then Save and Apply.
1.1. Configure WireGuard Interface – WireGuard pfSense
Now that we created our WireGuard tunnel, we have to create the WireGuard interface.
1. Select Interfaces then Assignments.
2. At the bottom, add the tunnel we just created. The name will be listed as OPT, then a number.
Select the interface (OPT8 below) to edit it.
3. Enable the interface and change the Description to whatever you’d like. Change the IPv4 Configuration type to Static IPv4.
4. In the Static IPv4 configuration, set the IP address as 10.200.0.1 /24. If you’d like to use a different subnet range, you can change the 10.200.0 to whatever you’d like (as long as it’s not currently in use). Set the MTU as 1420 (special thanks to r/pfsense for the info). Save and Apply the interface settings.
5. If you go back to the WireGuard Tunnel, you’ll now see that the interface is assigned to our Tunnel.
1.2 Firewall Rules – How to Set Up WireGuard on pfSense
Now that a WireGuard tunnel and interface has been created, we need to create two firewall rules. One for our WG_VPN interface, and one for WAN (to allow traffic on port 51820).
1. Select Firewall then Rules and under WG_VPN (our WireGuard Interface from above), Add a new rule.
2. Change the Protocol from TCP to Any and give the firewall rule a Description, then Save and Apply the rule.
3. Select WAN (same as step one, but for WAN instead of WG_VPN) and add a new firewall rule. Leave the Address Family as IPv4, then set the Protocol to UDP. Set the Destination as WAN address and set the custom port from and to 51820. Save and Apply the new firewall rule.
2. WireGuard Peer Configuration
At this point, the server configuration is complete and the firewall rules have been created. We will now create a “peer”, which is a client that will connect to our server.
The WireGuard Peer setup is slightly unique in the sense that you need to get the Public Key from the peer you’re setting up. This can be anything, from a Windows PC to a Mac/Linux device, or even an Android/iOS device. The process will be the same, meaning that you need to set up the interface on that device first. The YouTube video above explains this in detail.
I will quickly show Android and Windows examples, but please know that Mac, Linux and iOS devices will be extremely similar.
pfSense WireGuard Android Setup
1. On my Android device, I created a new WireGuard Tunnel by creating a Name and generating a Public/Private Key. In the Addresses section, I set it as 10.200.0.5/24, which is the IP address that will be assigned to this client. Make sure you add /24 or you will run into trouble connecting to other devices.
1.1. Set the DNS server to be whatever you’d like, then copy the public key and save. We will modify the WireGuard peer configuration on this device after we finish setting up pfSense.
pfSense WireGuard Setup for Windows
2. On Windows, add an Empty Tunnel. When you do, a Public Key and Private Key will be generated. In the Addresses section, I set it as 10.200.0.5/24, which will be the IP address that will be assigned to this client. Make sure you add /24 or you will run into trouble connecting to other devices.
2.1. Set the DNS server as whatever you’d like, then copy the public key and save. We will modify the WireGuard peer configuration on this device after we finish setting up pfSense.
pfSense Peer Configuration
3. On pfSense, select VPN then WireGuard, then select Peers and Add Peer.
4. In the Tunnel section, select the WireGuard VPN tunnel we created in step one. Create a Description, then enter the Public Key of the peer. To be clear, this information should be the public key on the device that you want to connect back to this server (either the Android or Windows device from above).
5. In the Allowed IPs section, set the IP address that you set in the client configuration, but make sure you use /32. The best way to think of this is the Allowed IPs on pfSense is the IP address that your client will use when connecting.
The peer is fully configured at this point, but if you’d like to increase security by ensuring a public key and pre-shared key will be required to connect, Generate a pre-shared key. You’ll then have to copy this and add it to the WireGuard Client configuration.
To be clear, this will require the WireGuard client to contain the pfSense servers Public Key and Pre-Shared Key in order to connect.
3. Client Device Configuration – How to Set Up WireGuard on pfSense
Now that the WireGuard peer has been configured on pfSense, we must set up the peer configuration on our client device.
Android WireGuard Client
1. Using our Android phone as an example, Public Key will be the Public Key of our pfSense WireGuard Tunnel. You can reference this information from the Tunnel configuration if needed in pfSense.
2. If you set up a pre-shared key above, enter the pre-shared key. If you didn’t, you can skip this step.
3. The endpoint will be your static external IP address. If you don’t have a static external IP address, it will be your DDNS hostname. If you don’t have a DDNS hostname, you can follow this tutorial to set one up using DuckDNS (free) or this one to set up DDNS using Cloudflare (you must own your own domain for this option). At the end, append port 51820.
Windows WireGuard Client
The same functionality will work on Windows, though you’ll have to type in the variables first. Below is an example configuration.
3.1 Split-Tunnel vs. Full-Tunnel VPN – How to Set Up WireGuard on pfSense
This section is important for future steps. We will be creating either a split-tunnel VPN or a full-tunnel VPN (or both).
- Split-Tunnel VPN: Traffic is only sent through your network if it is attempting to access an internal resource. Your IP address when navigating to a site outside of your network will be the IP address of the network that you are currently on.
- Full-Tunnel VPN: All traffic is sent through your VPN tunnel. Your IP address for internal and external requests will be your home networks. I created a very basic image below that explains this.
It’s important to understand that both VPN types will allow you to access your local network. This only shows how traffic is routed differently to external networks.
NOTE: This is not the exact network flow. I am simplifying the process as much as I can.
3.1.2 Split-Tunnel Client Configuration
In the AllowedIPs section, enter the IP addresses that you’d like sent through this VPN tunnel. At minimum, this should be your VPN subnet (in our case, 10.200.0.0/24) and LAN subnet (so that you can connect to your local devices). Separate all subnets that you’d like to access by a comma.
With this configuration, your external IP address when navigating to websites will be the network that you’re currently on.
3.1.2 Full-Tunnel Client Configuration
If you’d like to route ALL traffic through the VPN tunnel, set the AllowedIPs parameter to 0.0.0.0/0. This will route all traffic through the VPN tunnel.
With this configuration, your external IP address when navigating to websites will be the pfSense networks external IP address.
Windows – pfSense WireGuard Client Example
3. Connecting WireGuard Client to pfSense
Your entire configuration should be set up at this point and is ready to go! Ensure that you’re on an external network and connect. You should be able to connect to your LAN subnet and any local resources hosted on it. If you’re using a split-tunnel VPN, your external IP address should be the same as the network you’re currently connected to, and if you’re using a full-tunnel VPN, it should be the same as the pfSense network.
You can check that the client and server have made a “handshake” by selecting Status then WireGuard in pfSense and expanding the tunnel we created. If you’re connected and the handshake was successful, you will see a green handshake symbol.
3.1 Restart WireGuard Service on pfSense
If you ever have to restart the WireGuard service on pfSense, select Status then Services and select the Restart icon.
4. Conclusion – How to Set Up WireGuard on pfSense
This tutorial looked at how to Set up WireGuard on pfSense. Please keep in mind that this is still experimental and for that reason, you might run into unforeseen problems. As mentioned earlier, you can set up OpenVPN and run that on pfSense as well to ensure you can always connect to your local network.
As always, if you have any questions on how to set up WireGuard on pfSense, feel free to leave them in the comments of the YouTube video!
This Post Has One Comment
Thank you very much for the tutorial!
Comments are closed.