ax88179_178a.c fixed for proxmox (e.g. use with FreeBSD / opnsense)


New Member
Nov 28, 2019
by P.Steinberg

WHY I DID THIS: Because in opnsense / FreeBSD Passthrough of USB3 ax88179_178a was a pain. Either only 100Mbit or not working at all. Figured out it must be a driver problem in PVE in connection with FreeBSD.

THIS MOD works like the old driver in any Linux , but now also very nice as a Linux Bridge in FreeBSD or for my case opnsense 19.x

Everything needs to be done in the PVE Shell

I) Download and unpack driver and delete not working ax88179_178a.c file

cd ~ mkdir download cd download wget tar -xvjf AX88179_178A_LINUX_DRIVER_v1.19.0_SOURCE.tar.bz2 cd AX88179_178A_LINUX_DRIVER_v1.19.0_SOURCE rm ax88179_8178a.c

II) make new working ax88179_178a file
nano ax88179_178a.c

copy and paste this code to the editor

STRG + S to save
STRG + x to leave nano

III) Compile and copy the driver to the kernel files depending on your Kernel the Kernel Path need to be updated
in my case Kernel Version is "5.0.21-4-pve"
so path is : /lib/modules/5.0.21-4-pve/kernel/drivers/net/usb/

compile as follows:

make -j2 make install

you should now have a ax88179_178a.ko file

copy it to your kernel path - maybe backup the existing old ax88179_8178_a.ko

cp ax88179_178a.ko /lib/modules/5.0.21-4-pve/kernel/drivers/net/usb/ depmod -a modprobe ax88179_178a

Then reboot either Network manually or if you have no clue then
Reboot PVE

After that you can ad ax88179_178a to a vmbrX (Linux Bridge) and set this vmbrX as Network Card to your FreeBSD / opnsense

Reboot PVE again

Now the device should be full working in your FreeBSD / OPNSENSE with 1Gbit

Enjoy this mod - I hope i could help anyone

Took me looooong evenings to figure out and fix this. opnsense is running like a charme with it. ax88179_178a is in my case the WAN Adapter on a 200MBIt/s port so 100MBit/s was not enough.

cheers PSteinberg

Last edited:


The Proxmox community has been around for many years and offers help and support for Proxmox VE, Proxmox Backup Server, and Proxmox Mail Gateway.
We think our community is one of the best thanks to people like you!

Get your subscription!

The Proxmox team works very hard to make sure you are running the best software and getting stable updates and security enhancements, as well as quick enterprise support. Tens of thousands of happy customers have a Proxmox subscription. Get your own in 60 seconds.

Buy now!