summary refs log tree commit diff
path: root/nixos/doc/manual/configuration/network-manager.xml
blob: dafbcfcb1e5bda74ae9910802f5f06b305807fd9 (plain) (blame)
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
<section 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-networkmanager">

<title>NetworkManager</title>

<para>To facilitate network configuration, some desktop environments
use NetworkManager. You can enable NetworkManager by setting:

<programlisting>
networking.networkmanager.enable = true;
</programlisting>

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 <code>networkmanager</code> group:

<programlisting>
users.extraUsers.youruser.extraGroups = [ "networkmanager" ];
</programlisting>
</para>

<para>NetworkManager is controlled using either <command>nmcli</command> or
<command>nmtui</command> (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.</para>

<note><para><code>networking.networkmanager</code> and
<code>networking.wireless</code> (WPA Supplicant) cannot be enabled at the same
time: you can still connect to the wireless networks using
NetworkManager.</para></note>

</section>