Patched AMD XGBE driver for ASUSTOR Flashstor Gen2 on TrueNAS SCALE 25.10+
View the Project on GitHub nirok80/asustor-truenas-10gbe-driver
If you’ve got an ASUSTOR Flashstor Gen2 (FS6812X or FS6806X) and tried to install TrueNAS SCALE 25.10.1, you probably discovered that the 10GbE NIC doesn’t work. No network means a useless NAS.
This guide explains the problem and provides a working solution.
The ASUSTOR Flashstor Gen2 is an impressive all-NVMe NAS:
[1022:1458])The problem? That AMD 10GbE NIC has no out-of-box driver support in TrueNAS.
Someone at mihnea.net created a patched amd-xgbe driver that worked great with TrueNAS 24.10.x (kernel 6.6.44).
But when you upgrade to TrueNAS SCALE 25.10.1 (kernel 6.12), the driver won’t compile:
xgbe-ethtool.c: error: incompatible type for argument 2 of 'xgbe_get_rxfh'
xgbe-ethtool.c: error: incompatible type for argument 2 of 'xgbe_set_rxfh'
xgbe-ethtool.c: error: incompatible type for argument 2 of 'xgbe_get_ts_info'
xgbe-pci.c: error: 'PCI_IRQ_LEGACY' undeclared
The kernel APIs changed between 6.6 and 6.12. I wrote a patch that fixes all 4 breaking changes:
ethtool_rxfh_param structethtool_ts_info renamed to kernel_ethtool_ts_infoPCI_IRQ_LEGACY renamed to PCI_IRQ_INTXSSH into your TrueNAS box and run:
sudo install-dev-tools
# Download the pre-patched driver
wget https://github.com/nirok80/asustor-truenas-10gbe-driver/releases/download/v1.0.0/truenas-amd-xgbe-asustor-6.12-fixed.tar.bz2
# Extract
tar xvf truenas-amd-xgbe-asustor-6.12-fixed.tar.bz2
cd truenas-amd-xgbe-asustor-6.6.44
make
sudo make install
sudo modprobe amd-xgbe
ip link show
You should see your 10GbE interface (typically enp2s0f0).
Without this step, the driver disappears after reboot:
sudo mount -o remount,rw 'boot-pool/ROOT/25.10.1/'
sudo update-initramfs -u -k $(uname -r)
sudo mount -o remount,ro 'boot-pool/ROOT/25.10.1/'
install-dev-tools voids your TrueNAS supportFound a bug or have improvements? Open an issue or PR.