I made a WireGuard package for pfSense

  • Hey everyone.

    I wanted to try out WireGuard on my new pfSense router, and in the process I decided to make a package for it. I've been running it on my router for about a week without any issues, so I figured I'd share. Please note that both WireGuard and this package are still very experimental. Use at your own risk.

    Source and release is here: https://github.com/Ascrod/pfSense-pkg-wireguard Bug reports and PRs welcome.

    This package depends on the wireguard and wireguard-go ports for FreeBSD. You will need to download the appropriate builds for your version of pfSense, or build them, and then manually install them before installing this package. I am using wireguard-0.0.20190227_3 and wireguard-go-0.0.20181222 in my current setup.

    The package supports configuring one interface and any number of peers. Once you have them set up, go to the Assign Interfaces screen and create a new interface for tunwg0. Name it, enable it, and don't touch any other settings. Once the interface is up you can configure firewall rules for it and generally treat it the same as a physical interface. It should persist across reboots.

    Interface Editor
    Peer Editor
    Service Page
    Status Page

  • Excellent contribution, I would like to try it, but I am not able to compile it in pfsense.

    Could you share the package already compiled for pfsense v2.4.4-p3?

  • @pepe00 The release on the GitHub page should already be targeting 2.4.4-p3, the current release.

  • Sorry, I only found the source code and not the pfSense-pkg-wireguard-1.0.0.txz

    I already have it installed, I will perform tests

  • For my first test, I would like to connect my android mobile to my internal network.

    I create the "WireGuard" interface group, but I don't know what rules I have to add to the pfsense, could you help me?

    This is my configuration:
    My internal LAN:

    In pfsense:

    Address =
    ListenPort = 51000
    PrivateKey = server_private_key
    PostUp = ifconfig tunwg0 group WireGuard

    PublicKey = movil_public_key
    AllowedIPs =

    In android:

    PrivateKey = movil_private_key
    Address =
    DNS =

    PublicKey = server_public_key
    Endpoint = public_IP:51000
    AllowedIPs =

  • @pepe00 My bad, I should have explained this more - I have updated my initial post to include some instructions. When I get time I will also add a README to the repository.

    For a simple setup, you shouldn't need to create an interface group or configure a PostUp command. On the Interface Assignments page, create a new interface for tunwg0 and enable it. Don't touch any other interface settings. Once you have the interface set up, you can then forward the VPN's port (51000 in your case) to your interface's IP and assign firewall rules to it like any other interface. That should get you started.

    Looking at the config you posted, I think the interface address on your Android client needs to be a single address, not a range (e.g. Typically for mobile clients you also want to set AllowedIPs to,::/0 so that the interface can route all traffic over the tunnel. If you need more help configuring WireGuard itself, I can recommend this unofficial documentation, especially the examples.

    Hope that helps!

  • Thanks for your help!!!

    I created the "WireGuard" group, because I thought that the assignment of tungw0 would not be persistent to reboots, but I just verified that it is wrong.

    I have deleted the group and the PostUp rule.

    I have added a peer for another site (LAN: with pfsense:

    Endpoint = Public_IP_Site_B: 51000
    PublicKey = public_Site_B_key
    AllowedIPs =,

    Route tables were created automatically, and it worked without problems.

    The VPN road warrior from the mobile, still not working, I will have to check my settings. I have already applied the changes you suggested.

  • A very interesting functions would be:

    1. The possibility of automatically creating the private and public key of the peers.
    2. The possibility of exporting the peers configuration file.

    The WireGuard program for android, you can export and import a "wireguard-export.zip" with the wg0.conf inside.

    Do you see it viable or very complicated to program?

  • @pepe00 There are options for automatically generating a public/private key pair for the interface, and a PSK for a peer. Just click the respective checkboxes for those options and then click save. (I would like to make those into buttons that can work dynamically without saving, but I don't know if packages can make AJAX calls like that.) Note this will overwrite any keys or PSK already present.

    I'm not sure about importing and exporting the config file yet. Currently to export you could use scp to copy the config file under /etc/wireguard/ to your system; I'm not sure if you can import this way, as the package config might overwrite it. You can also copy-paste text from the configuration UI or from the status page (which shows the same info as if you had run wg show tunwg0 from the command line).

  • My idea is to add the possibility to export the client configuration file for a peer, to import it on the mobile device and configure it quickly, something similar to the "OpenVPN client export" plugin.

    I have already seen that there are options to automatically generate a public / private key pair for the interface and a PSK for the peer.

    What is missing is the option to automatically create a public / private key pair for the peer, with the intention of using that private key to generate the exportable configuration file.

    In the case of a road warrior connection, it is as simple as generating a [peer_name].txt with:

    Address = IP_peer
    DNS =
    PrivateKey = private_key_for_peer (self-generated in peer configure)

    AllowedIPs =, :: / 0
    Endpoint = Public_IP: UDP_port (request public_IP)
    PublicKey = public_key_server

    I don't know if I have explained myself better now, sorry for my English.

  • The VPN from my mobile already works!

    In addition to opening the UDP port in WAN and allowing the necessary traffic in WIRE (tungw0), so that the mobile can go to the internet, it is necessary to create a manual outbound NAT witch source rule in my case.

  • Is this plugin compatible with the new 2.4.5 release?
    Has anyone done a performance comparison with ipsec and openvpn so far?

    Anyway, thank you and keep up with the good work! 👍

  • I would also love to know if anyone has tried this out on 2.5, I imagine there could potentially be an issue because of the kernel update? But I have no clue myself.

    I just updated to 2.5 and was wondering if there was any update on wireguard working and of course only saw that someone had figured out a way to get it working after I updated.

    I'm so glad that someone decided to try to make it work! Been waiting on wireguard integration for too long. Keep up the great work!

  • @oneiro I intend to upgrade my router to 2.4.5 soon, along with wireguard and wireguard-go, and will post results; since it's a security/maintenance release, I don't expect too many issues.

    @BRH212 Unfortunately I don't have a spare physical machine to use for testing 2.5, but I did install all three packages on a VM and did some preliminary testing. Haven't see see any issues with the UI package so far.

    Keep in mind that this package is only an interface for the wireguard and wireguard-go packages (which I am not involved in the development of). You could theoretically use WG on pfSense without my package and it should still work, you'd just have to configure it from the console instead of the web UI.

    Also, be sure that the versions of wireguard and wireguard-go that you install match the version of FreeBSD for your pfSense install, otherwise you could potentially run into some issues. pkg should warn you if there's a version or architecture mismatch when attempting to add a package.

  • I would like to give this a try but I’m not a CLI person so don't know how to install the package or where to even start. Do I unpack the compressed file(s) and use something like WinSCP to place them into the directory? Thanks in advance

  • This post is deleted!

  • All right, I upgraded to 2.4.5 and so far I'm not seeing any issues. During the upgrade process pfSense-pkg-wireguard was removed, and after reboot I had to remove the old wireguard and wireguard-go packages before adding the new ones. I'm now using wireguard-1.0.20200319_2 and wireguard-go-20200320.

    @S762 Perhaps this page would be helpful to you? Assuming you haven't downloaded anything yet, you can use the command pkg add http://<url_to_pkg> to download and install a package from a URL - no need to unpack anything.

    If you're using pfSense 2.4.5 like I am, you can use these commands on the command line interface, or the Command Prompt page on the web interface:

    pkg add http://pkg.freebsd.org/FreeBSD:11:amd64/latest/All/wireguard-1.0.20200319_2.txz
    pkg add http://pkg.freebsd.org/FreeBSD:11:amd64/latest/All/wireguard-go-0.0.20200320.txz
    pkg add https://github.com/Ascrod/pfSense-pkg-wireguard/releases/download/v1.0.0/pfSense-pkg-wireguard-1.0.0.txz

    (I cannot stress enough that you should heed all the warnings about how using the command line or installing outside packages can possibly break your system. This is all very experimental and not officially supported in any way, and not for the faint of heart. If you don't mind taking a risk and/or are comfortable with the possibility of having to fix or reinstall your firewall, and you still want to try it out, make a configuration backup first!)

  • @Ascrod So I found this yesterday and I tired it for the first time just now. I'm on 2.4.5 and I used the links from your post just a few hours ago. I got no errors, but if I can into Assign Interfaces I don't see it. I see the Wireguard package status in my dash and it is stopped, but when I try to start it then it tries for a bit and then fails. The system log shows these entries every time I go through that process;

    Apr 12 12:29:22 kernel tunwg0: link state changed to DOWN
    Apr 12 12:29:22 kernel tun0: changing name to 'tunwg0'
    Apr 12 12:29:22 kernel tun0: link state changed to UP
    Apr 12 12:28:26 kernel tunwg0: link state changed to DOWN
    Apr 12 12:28:26 kernel tun0: changing name to 'tunwg0'
    Apr 12 12:28:26 kernel tun0: link state changed to UP
    Apr 12 12:27:41 kernel tunwg0: link state changed to DOWN
    Apr 12 12:27:41 kernel tun0: changing name to 'tunwg0'
    Apr 12 12:27:41 kernel tun0: link state changed to UP
    Apr 12 12:27:34 kernel igb3: promiscuous mode enabled

    Any ideas what it could be tripping up on?

  • As a follow up, it does show in VPN and I can configure things like the IP range and have it gen private and public keys. It seems the key will be being able to get that interface up and running and I'll be in business. Thanks for any suggestions you can provide.

    UPDATE - Once I'd input the items above, I could get the service to start. Once the service was started, i was able to assign the interface. Looks like I am in pretty good shape now. This is great work - I really hope they can get something like this into pfSense ASAP so we'll have support for upgrades and backups and such.

  • @burntoc You have to configure the VPN before you can use it... was that your issue?

    If you need to troubleshoot further, running WireGuard from the command line might help. I haven't figured out how to pipe all of WG's output to the log yet, so some errors may not be easy to troubleshoot from the web interface alone.

  • @Ascrod

    Hi and thanks for your effort.

    It would be great if you could make a step-by-step howto on how to set this up as as server, and with peers (road warrior) from a fresh install (and with client configs).

    I have installed, restarted services, assigned interface, created outbout NAT etc. in every different order, without any luck.

    I cannot make a conenction that routes traffic correctly. I can make a connection to the server, but the traffic does not pass.


  • @Ascrod Thank You! it took several attempts before it installed. Again I'm not a CLI person but received an error about “bash” so after an hour or so I figured bash needed to be installed once installed with pkg install bash and then was able to execute your commands in putty. I removed the bash with pkg remove bash and it removed the WG, not sure why that happened but I reinstalled bash and re-ran your commands and all is good again.

    Understood on the advice to use at your own risk, right now I have it on a test box and will continue with the test box before trying on the main system. As far as the client and peer setting I have the keys them from a Raspberry Pi WG install from a few weeks ago so I should just be able to plug those values in. I had the Pi working somewhat. The client would say active but I couldn’t see my Lan from the WG client so hoping to have better luck here with pfsense.

    Thanks again for doing this and the detailed explanation. Going to enter the Interface and Peer info tomorrow and see how it goes.

  • Well, fortunately, most of the existing guides out there for WireGuard will still be helpful here. This package doesn't do anything particularly special; it just provides a graphical interface for bringing the interface down or up, and for configuring the VPN. For the most part, WireGuard functionality and troubleshooting on pfSense/FreeBSD should be close to how it works on Ubuntu.

    Maybe you'd find the unofficial WireGuard docs useful? They have a number of examples posted that can probably get you started. The configuration interface should match pretty closely with the parameters used in the config file, and the start/restart button simply calls the wg-quick up and down commands.

    I have been having some issues with getting DNS requests to route through the VPN. If you set your DNS setting to something other than the VPN server, does traffic route properly?

  • @Ascrod

    It might be straight forward for people used to wireguard config interface/peers, for me it's not - even though I consider myself pretty advanced in config and troubleshooting.

    My last config broke my servers, resulting in some strange routing or whatever, so my internet went down. Everything started working once I stopped the wireguard service.

    I don't think its about DNS, as I cannot even ping LAN IP on pfsense server, or the wireguard interface IP of the server.

    I know my client works, because I already have a wireguard streisand server on another host behind my firewall (pfsense). Connecting to that server works great!

    I have even tried to compare the configs provided by streisand server, output of wg show/wg showconfig interface on both servers - without any luck on setting the parameteres on server and client config.

  • @cappiz I didn’t write down the steps, but here is the rough take on what worked for me earlier today.

    1. Run the pkg get commands from today’s earlier post. I did have to swap the first and second commands because it told me wireguard-go was a dependency for wireguard. I also had to pkg install bash.
    2. Rebooted the server. I did this b/c I couldn’t find the wireguard interface in the Assign Interfaces area as I understood from the comments in this thread. The service also wouldn’t start.
    3. After reboot, Wireguard showed up under my VPN lists, IIRC. I configured a network and had it autogen keys.
    4. Went into Services and saw Wireguard there, and I started it there.
    5. Went into Assign Interfaces and it was there, so I enabled the interface.

    HTH. YMMV.

  • @burntoc

    I did not use apt-get (ubuntu/debian based?) as I used pkg (and yes, I also had to swap the commands, and first install bash).

    I have/had the interface (assigned) up and running (needed to create interface and peer first).

    In the peer config - what is preshared key? I can't find any references to it in the documentations.

  • LAYER 8 Global Moderator

    While I do believe at some point this will get added to pfsense.. Until it is "officially" supported, be it added to the official package system - or just natively in the pfsense distro.. I would not suggest anyone play with this unless your ready to break your config, or be concerned with its security.

    When either someone takes the time to vet this through the pfsense developers to the point they add it to the package system. Or the official pfsense developers incorporate into the code - its not something anyone should be messing with that are not fully aware of all the possible consequences

    If you want to deploy this now, before its officially supported - I suggest you run this on some other box in your network and do it that way before you go dicking with anything to do with the pfsense install.

    If someone wants to help the community in deploying this - they should be putting together guides on how to run this on a different box in there network, vs suggesting anyone mess with base pfsense deployment.

  • This post is deleted!

  • @cappiz My apologies - misspoke there. You’re right, it was pkg get - corrected.

  • So here's another question for the crew. I realized that I'm actually going to run Wireguard on another device in my IOT zone and the msg from @johnpoz reminded me that if I don't have to have it here I probably shouldn't install it this way.

    How do you remove it? I used pkg delete to remove wireguard, wireguard-go, and bash, and I rolled back my config as well and rebooted, and I'm STILL seeing Wireguard as a service and in the VPN menu and defined interfaces.

  • @cappiz As I said in my first post, using WireGuard here is very much at your own risk; if you're having this much difficulty, please consider @johnpoz 's advice in setting WG up on a separate device instead. Also, please do NOT post any private keys publicly, they are private for a reason! I suggest changing your private and public key immediately.

    @burntoc It sounds like you also need to remove pfSense-pkg-wireguard. I'm not sure why pkg wouldn't have caught it when you removed wireguard and wireguard-go, but that might be your issue.

  • @Ascrod Thank you for the message. As best I can tell, there may be some package reinstallation tasks that try to put things back in order. I saved the config I'd restored to and removed the wireguard entries then reloaded it and everything looks good so far. If it acts up, I guess it will be my excuse to kick the tires on 2.5, LOL.

  • It is working! Thanks for package. How can I see wireguard logs?

  • @baran WireGuard doesn't provide much in the way of log files. You can check the status of the interface and peers on the status page, though (Status > WireGuard VPN)

  • Hi All,
    Would like some input. Im testing this on a pfsense install running in a vm. I seem to have all the port forwarding from my real/physical pfsense box to my vm-pfsense machine running the wireguard server.
    Im testing a connection from my android phone over cellular data connection. It seems to be able to connect to the wireguard vpn server. When i run the command "wg" it shows my cellphone's public IP as an endpoint. If i run a tcpdump on the vpn port i see a lot of UDP acitivy between the vpn server and my cell phone public IP.
    However i cannot ping any internal IPs or internet ip e.g Its like no traffic is passing through the tunnel.
    On the client side i do have allowed IPs set
    From the vpn server i can ping the phone on the vpn ip address, but i cannot ping the vpn servers interface Ip from the phone!

  • This post is deleted!

  • How can I add a new interface and configure it seperately from this package?

  • @baran WireGuard only supports one interface per configuration file. You will need to create and use a new config file entirely from the command line. Unfortunately you won't be able to use it with this package at this time.

  • Any input would be appreciated. I have the same issue as @cappiz where, when my wireguard service is running, my pfsense loses all internet connectivity on the WAN interface. Is there a need of some additional rules to be added or something?

  • @alirz I haven't been able to reproduce this, so I'm not sure what exactly would be causing it. A cursory Google search shows that others have had this problem, and doesn't appear to be specific to a particular OS. What happens if you restart the WG service? Are you only seeing traffic in one direction to/from the WAN port? Do you see anything unusual in your system logs?