summary refs log tree commit diff
path: root/nixos/doc/manual/configuration/network-manager.section.md
blob: 4bda21d34a10804c8ff03329fae204cfdd0e804b (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
38
39
40
41
42
# NetworkManager {#sec-networkmanager}

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

```nix
networking.networkmanager.enable = true;
```

some desktop managers (e.g., GNOME) enable NetworkManager automatically
for you.

All users that should have permission to change network settings must
belong to the `networkmanager` group:

```nix
users.users.alice.extraGroups = [ "networkmanager" ];
```

NetworkManager is controlled using either `nmcli` or `nmtui`
(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
[](#opt-programs.nm-applet.enable), the graphical applet will be
installed and will launch automatically when the graphical session is
started.

::: {.note}
`networking.networkmanager` and `networking.wireless` (WPA Supplicant)
can be used together if desired. To do this you need to instruct
NetworkManager to ignore those interfaces like:

```nix
networking.networkmanager.unmanaged = [
   "*" "except:type:wwan" "except:type:gsm"
];
```

Refer to the option description for the exact syntax and references to
external documentation.
:::