pyrox.dev
1<section xmlns="http://docbook.org/ns/docbook"
2 xmlns:xlink="http://www.w3.org/1999/xlink"
3 xmlns:xi="http://www.w3.org/2001/XInclude"
4 version="5.0"
5 xml:id="sec-networkmanager">
6 <title>NetworkManager</title>
7
8 <para>
9 To facilitate network configuration, some desktop environments use
10 NetworkManager. You can enable NetworkManager by setting:
11<programlisting>
12<xref linkend="opt-networking.networkmanager.enable"/> = true;
13</programlisting>
14 some desktop managers (e.g., GNOME) enable NetworkManager automatically for
15 you.
16 </para>
17
18 <para>
19 All users that should have permission to change network settings must belong
20 to the <code>networkmanager</code> group:
21<programlisting>
22<link linkend="opt-users.users._name__.extraGroups">users.users.alice.extraGroups</link> = [ "networkmanager" ];
23</programlisting>
24 </para>
25
26 <para>
27 NetworkManager is controlled using either <command>nmcli</command> or
28 <command>nmtui</command> (curses-based terminal user interface). See their
29 manual pages for details on their usage. Some desktop environments (GNOME,
30 KDE) have their own configuration tools for NetworkManager. On XFCE, there is
31 no configuration tool for NetworkManager by default: by adding
32 <code>networkmanagerapplet</code> to the list of system packages, the
33 graphical applet will be installed and will launch automatically when XFCE is
34 starting (and will show in the status tray).
35 </para>
36
37 <note>
38 <para>
39 <code>networking.networkmanager</code> and <code>networking.wireless</code>
40 (WPA Supplicant) cannot be enabled at the same time: you can still connect
41 to the wireless networks using NetworkManager.
42 </para>
43 </note>
44</section>