Keyboard Backlight Not Working on Linux: How to Actually Fix It on Fedora and CachyOS

Published on 2026-11-08 · 7 min read · By MiniTestLab Engineering Team · Category: Keyboards

Launch Companion Diagnostic Tool

Test your hardware right now in your browser with zero install:

Open Keyboard Tester

Your keyboard backlight is controlled through sysfs at /sys/class/leds/, and if it is not responding on Linux, the root cause is almost always a missing or misconfigured kernel module, a udev permission block, or a firmware-level ACPI conflict that prevents the driver from claiming the device. The backlight hardware itself is almost never dead. On most USB mechanical keyboards the LED controller is a separate MCU — often an STM32F072 or Holtek HT32F52342 — that receives commands over a HID report, and that MCU is functional even when Linux cannot talk to it. On laptops, the backlight is usually wired through an embedded controller exposed via ACPI WMI, and the kernel module for that vendor WMI interface simply may not be loaded.

Confirm the Hardware Is Alive First

Before touching a single config file, verify the keyboard itself is registering keystrokes correctly. Open the Keyboard Test in your browser and press every key. If every key lights up in the tester but the backlight stays dark, the switch matrix and USB HID descriptor are fine and the problem is purely on the software side. If keys are also dropping, you have a separate HID enumeration problem and the backlight is a secondary symptom.

Next, check what the kernel actually sees:

Module and Driver Fixes for Fedora and CachyOS

Fedora ships a conservative kernel config. CachyOS ships a heavily patched BORE or EEVDF scheduler kernel that occasionally drops or renames out-of-tree modules between updates. The approach differs slightly between them.

Common USB keyboard backlight drivers and their module names:

Keyboard / Controller Kernel Module Load Command
ITE 8291 (many Anne Pro 2, Royal Kludge boards) hid-ite modprobe hid-ite
Holtek-based (Ducky, Varmilo OEM) hid-holtek-kbd modprobe hid-holtek-kbd
Corsair (iCUE keyboards) hid-corsair modprobe hid-corsair
Laptop ACPI WMI (Asus, MSI, Lenovo) asus-wmi / msi-wmi / ideapad-laptop modprobe asus-wmi
OpenRGB-supported boards (generic fallback) usbhid + userspace daemon Install openrgb package

On Fedora, load the module and make it persistent:

  1. Run sudo modprobe hid-ite (substitute your module name).
  2. Check /sys/class/leds/ again. If the entry appears, make it permanent: echo "hid-ite" | sudo tee /etc/modules-load.d/kbd-backlight.conf
  3. If Fedora's SELinux is blocking sysfs writes, check sudo ausearch -m avc -ts recent and apply the relevant boolean with sudo setsebool.

On CachyOS, the kernel version changes frequently via the linux-cachyos or linux-cachyos-bore packages. After a kernel update, out-of-tree DKMS modules must rebuild. Run sudo dkms autoinstall after each kernel upgrade. If you are using OpenRGB as a DKMS module, check dkms status for a broken state and reinstall with sudo pacman -S openrgb-dkms.

sysfs Permissions and udev Rules

Even when the driver loads, a non-root user cannot write to /sys/class/leds/*/brightness by default. The fix is a udev rule, not a chmod on the sysfs node — sysfs permissions reset on every boot.

Create the file /etc/udev/rules.d/90-kbd-backlight.rules with this content:

ACTION=="add", SUBSYSTEM=="leds", KERNEL=="*kbd_backlight", RUN+="/bin/chmod a+w /sys/class/leds/%k/brightness"

Then run sudo udevadm control --reload-rules and sudo udevadm trigger. Replug the keyboard. Test by writing a value directly: echo 128 > /sys/class/leds/ite_8291::rgb:kbd_backlight/brightness. The valid range is shown in the adjacent max_brightness file — read it first with cat /sys/class/leds/ite_8291::rgb:kbd_backlight/max_brightness.

If you are on a laptop and using GNOME, the backlight slider in Settings > Power > Keyboard Brightness talks to logind via D-Bus, not sysfs directly. Confirm logind sees the device: loginctl show-session $(loginctl | awk 'NR==2{print $1}') | grep -i bright. If the property is missing, logind has not enumerated the LED class device, which points back to the missing module.

Comparison: Backlight Control Methods on Linux

Method Works Without Root Survives Reboot Supports RGB Per-Key Fedora Ready CachyOS Ready
Direct sysfs write Only with udev rule No (value resets) No Yes Yes
logind / D-Bus Yes (session user) Yes No Yes Yes
OpenRGB daemon Yes (after udev setup) Yes (systemd service) Yes Needs RPM Fusion or Flatpak Yes (AUR/pacman)
vendor CLI tool (e.g., g810-led) Only with udev rule Via systemd unit Yes (Logitech) Manual build AUR available

If you want to confirm your physical keys are all registering correctly after any of these changes, run the Keyboard Test again. For laptops where the backlight fix touched power management settings, also double-check your microphone and webcam are still functional with the Mic Test — aggressive ACPI patches occasionally mute unrelated devices.

Frequently Asked Questions

Why does the backlight work in Windows but not Linux on the same machine?

Windows uses a vendor HID driver that speaks a proprietary HID usage page to the keyboard's MCU. Linux's generic HID stack does not know about those vendor-specific report IDs unless a dedicated kernel module or userspace tool like OpenRGB implements them. The hardware is identical; the protocol translation layer is missing on the Linux side.

My fedora keyboard backlight not working issue appeared after a dnf update. What changed?

A kernel update likely rebuilt the initramfs without your custom module in it, or SELinux policy was tightened. Run rpm -q --changelog kernel | head -40 to see what changed, check dmesg | grep hid for denied messages, and re-run the modprobe and udev steps above. Also verify your udev rule file still exists — some package updates overwrite files in /etc/udev/rules.d/ if there is a naming conflict.

I have a cachyos keyboard backlight not working problem only after suspend. How do I fix it?

The LED controller MCU loses its state on USB suspend. Create a systemd service that runs echo [value] > /sys/class/leds/.../brightness on the post-resume target. Place it at /etc/systemd/system/kbd-backlight-resume.service with WantedBy=suspend.target and After=suspend.target. Enable it with sudo systemctl enable kbd-backlight-resume.service.

Does linux keyboard backlight not working indicate a failing keyboard controller?

Rarely. If the keyboard passes a full keypress test in the Keyboard Test with no missing keys, the STM32 or Holtek MCU is functional. A dead LED controller would typically also corrupt the HID descriptor, causing keys to drop. Physical LED failure usually shows as individual LEDs dark, not the entire backlight absent.

Can I control per-key RGB without OpenRGB?

On a small number of keyboards with mainline kernel support — notably some Logitech G-series via hid-logitech-hidpp and some Corsair boards via hid-corsair — you can write directly to sysfs multi-color LED nodes under /sys/class/leds/. For most gaming keyboards the answer is no without OpenRGB or a vendor daemon, because the per-key protocol is entirely proprietary and not exposed through standard LED class interfaces.

Will setting max brightness damage the LEDs?

No. The max_brightness value in sysfs is the ceiling the driver allows based on what the firmware reports as safe. Writing that value does not exceed the LED's rated forward current — the MCU's PWM controller handles current limiting. Long-term running at maximum brightness does increase junction temperature on the LED dies, which accelerates lumen depreciation over years, but it will not cause immediate damage.

Launch Companion Diagnostic Tool

Test your hardware right now in your browser with zero install:

Open Keyboard Tester