Link Search Menu Expand Document

Unsupported distributions

We try to support as many Linux distributions as possible. But there are so many that it’s impossible to test all of them. Also, some do not provide the required kernel headers and build tools, or target exotic hardware that we don’t have access to.

📝 Note that if your distribution is unsupported and you didn’t notice it when you purchased our adapter, you may return the adapter back to Amazon for a refund, as it comes with a two-year warranty.

Here are some of the distributions that we tested where our installer either doesn’t work at all, or it requires an unreasonable amount of effort:

DistributionVersionHeaders packageRemarks
CentOS Linux8kernel-develdnf, see note 1
CentOS Stream8kernel-develdnf, see note 1
Endless OSEndless 3.8.7-ostree+flatpak, unsupported
Guix1.3.0linux-libre-headersNo FHS, unsupported
openSUSE Leap15.2kernel-develzypper, see note 2
Puppy LinuxFossaPup64 9.5kernel_sources-5.4.53-fossapup64.sfsppm, install devx.sfs first
Red Hat Enterprise Linux8.3kernel-develdnf, see note 1
Tails4.17linux-headers-amd64apt, live only, unsupported
Tiny Core Linux12-tcz, unsupported
Windows Subsystem for LinuxWSL 2-VM, unsupported

Notes

  1. CentOS and RHEL backport some new features to older kernels, confusing the Realtek driver. Currently the driver can only work by installing the kernel-lt and kernel-lt-devel packages, which upgrade to thelong term support kernel (or the -ml ones which upgrade to the mainline kernel). Additionally, dkms isn’t included in their stock repositories. Our driver can work without it, but it’s best if you make it available.

     # Add the repository for dkms
     sudo rpm -ivh http://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
     # Add the repository for the -lt kernels
     sudo rpm -ivh https://www.elrepo.org/elrepo-release-8.el8.elrepo.noarch.rpm
     # Install the -lt kernels
     sudo dnf install -y --enablerepo=elrepo-kernel kernel-lt kernel-lt-devel
     # Then reboot, then run our installer
    
  2. openSUSE Leap backports some new features to older kernels, confusing the Realtek driver. Currently the driver is only supported on openSUSE Tumbleweed, which comes with a newer kernel.

See also the supported distributions list.