nixos/doc/manual/from_md/configuration/network-manager.section.xml


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="sec-networkmanager">
  <title>NetworkManager</title>
  <para>
    To facilitate network configuration, some desktop environments use
    NetworkManager. You can enable NetworkManager by setting:
  </para>
  <programlisting language="bash">
networking.networkmanager.enable = true;
</programlisting>
  <para>
    some desktop managers (e.g., GNOME) enable NetworkManager
    automatically for you.
  </para>
  <para>
    All users that should have permission to change network settings
    must belong to the <literal>networkmanager</literal> group:
  </para>
  <programlisting language="bash">
users.users.alice.extraGroups = [ &quot;networkmanager&quot; ];
</programlisting>
  <para>
    NetworkManager is controlled using either <literal>nmcli</literal>
    or <literal>nmtui</literal> (curses-based terminal user interface).
    See their manual pages for details on their usage. Some desktop
    environments (GNOME, KDE) have their own configuration tools for
    NetworkManager. On XFCE, there is no configuration tool for
    NetworkManager by default: by enabling
    <xref linkend="opt-programs.nm-applet.enable" />, the graphical
    applet will be installed and will launch automatically when the
    graphical session is started.
  </para>
  <note>
    <para>
      <literal>networking.networkmanager</literal> and
      <literal>networking.wireless</literal> (WPA Supplicant) can be
      used together if desired. To do this you need to instruct
      NetworkManager to ignore those interfaces like:
    </para>
    <programlisting language="bash">
networking.networkmanager.unmanaged = [
   &quot;*&quot; &quot;except:type:wwan&quot; &quot;except:type:gsm&quot;
];
</programlisting>
    <para>
      Refer to the option description for the exact syntax and
      references to external documentation.
    </para>
  </note>
</section>