diff --git a/nixos/doc/manual/configuration.xml b/nixos/doc/manual/configuration.xml
index 98686a19f1e..051f0fb8c1e 100644
--- a/nixos/doc/manual/configuration.xml
+++ b/nixos/doc/manual/configuration.xml
@@ -1036,21 +1036,22 @@ users.extraUsers.alice =
{ createHome = true;
home = "/home/alice";
description = "Alice Foobar";
- extraGroups = [ "wheel" ];
+ extraGroups = [ "wheel" "networkmanager" ];
useDefaultShell = true;
openssh.authorizedKeys.keys = [ "ssh-dss AAAAB3Nza... alice@foobar" ];
};
Note that alice is a member of the
-wheel group, which allows her to use
-sudo to execute commands as
-root. Also note the SSH public key that allows
-remote logins with the corresponding private key. Users created in
-this way do not have a password by default, so they cannot log in via
-mechanisms that require a password. However, you can use the
-passwd program to set a password, which is retained
-across invocations of nixos-rebuild.
+wheel and networkmanager groups,
+which allows her to use sudo to execute commands as
+root and to configure the network, respectively.
+Also note the SSH public key that allows remote logins with the
+corresponding private key. Users created in this way do not have a
+password by default, so they cannot log in via mechanisms that require
+a password. However, you can use the passwd program
+to set a password, which is retained across invocations of
+nixos-rebuild.
A user ID (uid) is assigned automatically. You can also specify
a uid manually by adding
@@ -1277,6 +1278,28 @@ services.xserver.synaptics.twoFingerScroll = true;
Networking
+NetworkManager
+
+To facilitate network configuration, some desktop environments
+use NetworkManager. You can enable NetworkManager by setting:
+
+
+services.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.
+
+services.networkmanager
and
+services.wireless
can not be enabled at the same time:
+you can still connect to the wireless networks using
+NetworkManager.
+
+
+
Secure shell access
Secure shell (SSH) access to your machine can be enabled by
@@ -1399,6 +1422,11 @@ always allowed.)
Wireless networks
+For a desktop installation using NetworkManager (e.g., GNOME),
+you just have to make sure the user is in the
+networkmanager
group and you can skip the rest of this
+section on wireless networks.
+
NixOS will start wpa_supplicant for you if you enable this setting: