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).
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.
uname -r reports a higher version number, then you’ve successfully booted with the kernel shipped by
“Unsupported Hardware Detected” error
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
System Tools →
Layout, 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.
localectl set-x11-keymap us dell ,qwerty compose:caps.
This generates the appropriate configuration in
This file is auto-generated.
Do not edit it by hand, unless you know what you are doing.
xorg is required.
The most straightforward way is to reboot the system.