Home Explore Blog CI



nixpkgs

nixos/doc/manual/configuration/network-manager.section.md
1af479f7f8c4e853633d7999f07a2e5d095afba6fb11d3990000000300000557
# 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.
:::

Chunks
27d41455 (1st chunk of `nixos/doc/manual/configuration/network-manager.section.md`)
Title: Enabling and Configuring NetworkManager
Summary
NetworkManager can be enabled in the NixOS configuration to facilitate network configuration, particularly in desktop environments like GNOME. Users who need to modify network settings must be added to the 'networkmanager' group. NetworkManager can be controlled via command-line tools like 'nmcli' and 'nmtui', or through graphical interfaces provided by some desktop environments. It's also possible to use NetworkManager in conjunction with WPA Supplicant, by instructing NetworkManager to ignore specific interfaces.