forked from mirrors/nixpkgs
141 lines
4.7 KiB
XML
141 lines
4.7 KiB
XML
<chapter xmlns="http://docbook.org/ns/docbook"
|
||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||
version="5.0"
|
||
xml:id="sec-x11">
|
||
|
||
<title>X Window System</title>
|
||
|
||
<para>The X Window System (X11) provides the basis of NixOS’ graphical
|
||
user interface. It can be enabled as follows:
|
||
<programlisting>
|
||
services.xserver.enable = true;
|
||
</programlisting>
|
||
The X server will automatically detect and use the appropriate video
|
||
driver from a set of X.org drivers (such as <literal>vesa</literal>
|
||
and <literal>intel</literal>). You can also specify a driver
|
||
manually, e.g.
|
||
<programlisting>
|
||
services.xserver.videoDrivers = [ "r128" ];
|
||
</programlisting>
|
||
to enable X.org’s <literal>xf86-video-r128</literal> driver.</para>
|
||
|
||
<para>You also need to enable at least one desktop or window manager.
|
||
Otherwise, you can only log into a plain undecorated
|
||
<command>xterm</command> window. Thus you should pick one or more of
|
||
the following lines:
|
||
<programlisting>
|
||
services.xserver.desktopManager.plasma5.enable = true;
|
||
services.xserver.desktopManager.xfce.enable = true;
|
||
services.xserver.desktopManager.gnome3.enable = true;
|
||
services.xserver.windowManager.xmonad.enable = true;
|
||
services.xserver.windowManager.twm.enable = true;
|
||
services.xserver.windowManager.icewm.enable = true;
|
||
services.xserver.windowManager.i3.enable = true;
|
||
</programlisting>
|
||
</para>
|
||
|
||
<para>NixOS’s default <emphasis>display manager</emphasis> (the
|
||
program that provides a graphical login prompt and manages the X
|
||
server) is SLiM. You can select an alternative one by picking one
|
||
of the following lines:
|
||
<programlisting>
|
||
services.xserver.displayManager.sddm.enable = true;
|
||
services.xserver.displayManager.lightdm.enable = true;
|
||
</programlisting>
|
||
</para>
|
||
|
||
<para>You can set the keyboard layout (and optionally the layout variant):
|
||
<programlisting>
|
||
services.xserver.layout = "de";
|
||
services.xserver.xkbVariant = "neo";
|
||
</programlisting>
|
||
</para>
|
||
|
||
<para>The X server is started automatically at boot time. If you
|
||
don’t want this to happen, you can set:
|
||
<programlisting>
|
||
services.xserver.autorun = false;
|
||
</programlisting>
|
||
The X server can then be started manually:
|
||
<screen>
|
||
# systemctl start display-manager.service
|
||
</screen>
|
||
</para>
|
||
|
||
|
||
<simplesect><title>NVIDIA Graphics Cards</title>
|
||
|
||
<para>NVIDIA provides a proprietary driver for its graphics cards that
|
||
has better 3D performance than the X.org drivers. It is not enabled
|
||
by default because it’s not free software. You can enable it as follows:
|
||
<programlisting>
|
||
services.xserver.videoDrivers = [ "nvidia" ];
|
||
</programlisting>
|
||
Or if you have an older card, you may have to use one of the legacy drivers:
|
||
<programlisting>
|
||
services.xserver.videoDrivers = [ "nvidiaLegacy340" ];
|
||
services.xserver.videoDrivers = [ "nvidiaLegacy304" ];
|
||
services.xserver.videoDrivers = [ "nvidiaLegacy173" ];
|
||
</programlisting>
|
||
You may need to reboot after enabling this driver to prevent a clash
|
||
with other kernel modules.</para>
|
||
|
||
<para>On 64-bit systems, if you want full acceleration for 32-bit
|
||
programs such as Wine, you should also set the following:
|
||
<programlisting>
|
||
hardware.opengl.driSupport32Bit = true;
|
||
</programlisting>
|
||
</para>
|
||
|
||
</simplesect>
|
||
|
||
<simplesect><title>AMD Graphics Cards</title>
|
||
|
||
<para>AMD provides a proprietary driver for its graphics cards that
|
||
has better 3D performance than the X.org drivers. It is not enabled
|
||
by default because it’s not free software. You can enable it as follows:
|
||
<programlisting>
|
||
services.xserver.videoDrivers = [ "ati_unfree" ];
|
||
</programlisting>
|
||
You will need to reboot after enabling this driver to prevent a clash
|
||
with other kernel modules.</para>
|
||
|
||
<para>On 64-bit systems, if you want full acceleration for 32-bit
|
||
programs such as Wine, you should also set the following:
|
||
<programlisting>
|
||
hardware.opengl.driSupport32Bit = true;
|
||
</programlisting>
|
||
</para>
|
||
|
||
</simplesect>
|
||
|
||
<simplesect><title>Touchpads</title>
|
||
|
||
<para>Support for Synaptics touchpads (found in many laptops such as
|
||
the Dell Latitude series) can be enabled as follows:
|
||
<programlisting>
|
||
services.xserver.libinput.enable = true;
|
||
</programlisting>
|
||
The driver has many options (see <xref linkend="ch-options"/>). For
|
||
instance, the following disables tap-to-click behavior:
|
||
<programlisting>
|
||
services.xserver.libinput.tapping = false;
|
||
</programlisting>
|
||
Note: the use of <literal>services.xserver.synaptics</literal> is deprecated since NixOS 17.09.
|
||
</para>
|
||
|
||
</simplesect>
|
||
|
||
<simplesect><title>GTK/Qt themes</title>
|
||
|
||
<para>GTK themes can be installed either to user profile or system-wide (via
|
||
<literal>system.environmentPackages</literal>). To make Qt 5 applications look similar
|
||
to GTK2 ones, you can install <literal>qt5.qtbase.gtk</literal> package into your
|
||
system environment. It should work for all Qt 5 library versions.
|
||
</para>
|
||
|
||
</simplesect>
|
||
|
||
</chapter>
|