mirror of
https://github.com/QubesOS/qubes-doc.git
synced 2025-07-30 01:59:11 -04:00
7e464d0f40
This is done using tools at https://github.com/maiska/qubes-translation-utilz, commit 4c8e2a7f559fd37e29b51769ed1ab1c6cf92e00d.
42 lines
2.7 KiB
ReStructuredText
42 lines
2.7 KiB
ReStructuredText
========================
|
||
Hardware troubleshooting
|
||
========================
|
||
|
||
|
||
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 :ref:`here <user/advanced-topics/how-to-install-software-in-dom0:kernel upgrade>` for more information about upgrading kernels in dom0). In dom0:
|
||
|
||
.. code:: bash
|
||
|
||
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 :ref:`Installation Troubleshooting <user/troubleshooting/installation-troubleshooting:"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 ``Q`` → ``System Tools`` → ``Keyboard`` → ``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.
|
||
|
||
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 <https://groups.google.com/d/topic/qubes-devel/d8ZQ_62asKI/discussion>`__ and `this GitHub issue <https://github.com/QubesOS/qubes-issues/issues/1396>`__.
|