Troubleshooting hardware-related issues

Audio doesn’t work / Troubleshooting newer hardware

By default, the kernel that is installed in dom0 comes from the kernel package, which is an older Linux LTS kernel. For most cases this works fine since the Linux kernel developers backport fixes to this kernel, but for some newer hardware, you may run into issues. For example, the audio might not work if the sound card is too new for the LTS kernel. To fix this, you can try the kernel-latest package – though be aware that it’s less tested! (See here for more information about upgrading kernels in dom0). In dom0:

sudo qubes-dom0-update kernel-latest

Reboot when it’s done installing. You can double-check that the boot used the newer kernel with uname -r, which prints the version of the currently-running kernel. Compare this with the output of rpm -q kernel. If the start of uname -r matches one of the versions printed by rpm, then you’re still using the Linux LTS kernel, and you’ll probably need to manually fix your boot settings. If uname -r reports a higher version number, then you’ve successfully booted with the kernel shipped by kernel-latest.

“Unsupported Hardware Detected” error

See Installation Troubleshooting.

Keyboard layout settings not behaving correctly

The best approach is to choose the right keyboard layout during the installation process. But if you want to change things afterwards, you can try this workaround.

Assuming XFCE desktop: in QSystem ToolsKeyboardLayout, leave the checkbox “Use system defaults” checked. Do not customize the keyboard layout here.

Set the system-wide layout and options for xorg with the localectl command in dom0. You can use localectl --help as a starting point.

Example: localectl set-x11-keymap us dell ,qwerty compose:caps.

This generates the appropriate configuration in /etc/X11/xorg.conf.d/00-keyboard.conf. This file is auto-generated. Do not edit it by hand, unless you know what you are doing.

Restarting xorg is required. The most straightforward way is to reboot the system.

More information in this discussion and this GitHub issue.