ublue-os akmods

A layer for adding extra kernel modules to your image. Use for better hardware support and a few other features!

Features

Feel free to PR more kmod build scripts into this repo!

ublue-os-akmods-addons - installs extra repos and our kmods signing key; install and import to allow SecureBoot systems to use these kmods
ublue-os-nvidia-addons - installs extra repos enabling our nvidia support
- nvidia container selinux policy - uses RHEL9 policy as the closest match
- nvidia-container-tookkit repo - version 1.14 (and newer) provide CDI for podman use of nvidia gpus
ayaneo-platform - Linux drivers for AYANEO x86 handhelds (akmod from ublue-os/akmods copr)
ayn-platform - Linux drivers for AYN x86 handhelds (akmod from ublue-os/akmods copr)
bmi160 - kernel module driver for the BMI160 IMU (akmod from ublue-os/akmods copr)
bmi260 - kernel module driver for the Bosch BMI260 IMU (akmod from ublue-os/akmods copr)
bmi323 - kernel module driver for the Bosch BMI323 IMU (akmod from ublue-os/akmods copr)
evdi - kernel module required for use of displaylink (akmod from negativo17 multimedia repo
gasket/apex - kernel module for Coral Gasket Driver, allowing usage of the Coral EdgeTPU on Linux systems (akmod from ublue-os/akmods copr)
gcadapter_oc - kernel module for overclocking the Nintendo Wii U/Mayflash GameCube adapter (akmod from ublue-os/akmods copr)
nct6687d - Linux kernel module for Nuvoton NCT6687-R found on AMD B550 chipset motherboards (akmod from ublue-os/akmods copr)
nvidia - nvidia GPU drivers built from rpmfusion
openrazer - kernel module adding additional features to Razer hardware (akmod from ublue-os/akmods copr)
openrgb - kernel module with i2c-nct6775 and patched i2c-piix4 for use with OpenRGB (akmod from ublue-os/akmods copr)
rtl8814au - Realtek RTL8814AU Driver (akmod from ublue-os/akmods copr)
rtl88xxau - Realtek RTL8812AU/21AU and RTL8814AU driver (akmod from ublue-os/akmods copr)
ryzen_smu - A Linux kernel driver that exposes access to the SMU (System Management Unit) for certain AMD Ryzen Processors (akmod from ublue-os/akmods copr)
steamdeck - platform driver for Valve's Steam Deck handheld PC (akmod from ublue-os/akmods copr)
v4l2loopback - allows creating "virtual video devices"
winesync - Support for Winesync/Fastsync/NTSync primitives (akmod from ublue-os/akmods copr)
wl (broadcom) - support for some legacy broadcom wifi devices
xpadneo - xbox one controller bluetooth driver (akmod from negativo17 steam repo
xonedo - xbox one controller USB wired/RF driver modified to work along-side xpad (akmod from ublue-os/akmods copr)
zenergy - Based on AMD_ENERGY driver, but with some jiffies added so non-root users can read it safely. (akmod from ublue-os/akmods copr)

How it's organized

The akmods image is built and published daily. However, there's not a single image but several, given various kernel support we now provide.

Here's a rundown on how it's organized.

We do our best to support all current builds of Fedora, current versions of the kernel modules listed, and in the case of NVIDIA, current (545) and the 470 legacy driver.

The majority of the drivers are tagged with KERNEL_TYPE-FEDORA_RELEASE. NVIDIA drivers are bundled distinctly with tag KERNEL_TYPE-FEDORA_RELEASE-NVIDIA_VERSION.

KERNEL_TYPE	FEDORA_RELEASE	TAG
Fedora stock kernel	38	`main-38`, `main-38-470` `main-38-545`
	39	`main-39`, `main-39-470` `main-39-545`
patched for ASUS devices	38	`asus-38`, `asus-38-470` `asus-38-545`
	39	`asus-39`, `asus-39-470` `asus-39-545`
patched Microsoft Surface devices	38	`surface-38`, `surface-38-545`
	39	`surface-39`, `surface-39-545`

Usage

To install one of these kmods, you'll need to install any of their specific dependencies (checkout the build-prep.sh and the specific build-FOO.sh script for details.

For common images, add something like this to your Containerfile, replacing TAG with one of the something-FR tags above:

COPY --from=ghcr.io/ublue-os/akmods:TAG /rpms/ /tmp/rpms
RUN find /tmp/rpms
RUN rpm-ostree install /tmp/rpms/ublue-os/ublue-os-akmods*.rpm
RUN rpm-ostree install /tmp/rpms/kmods/kmod-v4l2loopback*.rpm

For NVIDIA images, add something like this to your Containerfile, replacing TAG with one of the something-FR-NVV tags above:

COPY --from=ghcr.io/ublue-os/akmods:TAG /rpms/ /tmp/rpms
RUN find /tmp/rpms
RUN rpm-ostree install /tmp/rpms/ublue-os/ublue-os-nvidia*.rpm
RUN rpm-ostree install /tmp/rpms/kmods/kmod-nvidia.rpm

These examples show:

copying all the rpms from the respective akmods images
installing the respective ublue specific RPM
installing a kmods RPM.

Adding kmods

If you have a kmod you want to contribute send a pull request by adding a script using build-kmod-wl.sh as an example.

Verification

These images are signed with sisgstore's cosign. You can verify the signature by downloading the cosign.pub key from this repo and running the following command, replacing RELEASE with either 38 or 39: