pyrox.dev
1<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="sec-networkmanager">
2 <title>NetworkManager</title>
3 <para>
4 To facilitate network configuration, some desktop environments use
5 NetworkManager. You can enable NetworkManager by setting:
6 </para>
7 <programlisting language="bash">
8networking.networkmanager.enable = true;
9</programlisting>
10 <para>
11 some desktop managers (e.g., GNOME) enable NetworkManager
12 automatically for you.
13 </para>
14 <para>
15 All users that should have permission to change network settings
16 must belong to the <literal>networkmanager</literal> group:
17 </para>
18 <programlisting language="bash">
19users.users.alice.extraGroups = [ "networkmanager" ];
20</programlisting>
21 <para>
22 NetworkManager is controlled using either <literal>nmcli</literal>
23 or <literal>nmtui</literal> (curses-based terminal user interface).
24 See their manual pages for details on their usage. Some desktop
25 environments (GNOME, KDE) have their own configuration tools for
26 NetworkManager. On XFCE, there is no configuration tool for
27 NetworkManager by default: by enabling
28 <xref linkend="opt-programs.nm-applet.enable" />, the graphical
29 applet will be installed and will launch automatically when the
30 graphical session is started.
31 </para>
32 <note>
33 <para>
34 <literal>networking.networkmanager</literal> and
35 <literal>networking.wireless</literal> (WPA Supplicant) can be
36 used together if desired. To do this you need to instruct
37 NetworkManager to ignore those interfaces like:
38 </para>
39 <programlisting language="bash">
40networking.networkmanager.unmanaged = [
41 "*" "except:type:wwan" "except:type:gsm"
42];
43</programlisting>
44 <para>
45 Refer to the option description for the exact syntax and
46 references to external documentation.
47 </para>
48 </note>
49</section>