diff --git a/nixos/doc/manual/installation/installing.xml b/nixos/doc/manual/installation/installing.xml
index d019bb318096..ff2425e725e8 100644
--- a/nixos/doc/manual/installation/installing.xml
+++ b/nixos/doc/manual/installation/installing.xml
@@ -64,14 +64,51 @@
- To manually configure the network on the graphical installer, first disable
- network-manager with systemctl stop NetworkManager.
+ On the graphical installer, you can configure the network, wifi included,
+ through NetworkManager. Using the nmtui program, you
+ can do so even in a non-graphical session. If you prefer to configure the
+ network manually, disable NetworkManager with
+ systemctl stop NetworkManager.
- To manually configure the wifi on the minimal installer, run
- wpa_supplicant -B -i interface -c <(wpa_passphrase 'SSID'
- 'key').
+ On the minimal installer, NetworkManager is not available, so configuration
+ must be perfomed manually. To configure the wifi, first start wpa_supplicant
+ with sudo systemctl start wpa_supplicant, then run
+ wpa_cli. For most home networks, you need to type
+ in the following commands:
+
+> add_network
+0
+> set_network 0 ssid "myhomenetwork"
+OK
+> set_network 0 psk "mypassword"
+OK
+> set_network 0 key_mgmt WPA-PSK
+OK
+> enable_network 0
+OK
+
+ For enterprise networks, for example eduroam, instead do:
+
+> add_network
+0
+> set_network 0 ssid "eduroam"
+OK
+> set_network 0 identity "myname@example.com"
+OK
+> set_network 0 password "mypassword"
+OK
+> set_network 0 key_mgmt WPA-EAP
+OK
+> enable_network 0
+OK
+
+ When successfully connected, you should see a line such as this one
+
+<3>CTRL-EVENT-CONNECTED - Connection to 32:85:ab:ef:24:5c completed [id=0 id_str=]
+
+ you can now leave wpa_cli by typing quit.
diff --git a/nixos/modules/profiles/installation-device.nix b/nixos/modules/profiles/installation-device.nix
index 8e3aa20daa65..3c503fba2a39 100644
--- a/nixos/modules/profiles/installation-device.nix
+++ b/nixos/modules/profiles/installation-device.nix
@@ -54,7 +54,12 @@ with lib;
An ssh daemon is running. You then must set a password
for either "root" or "nixos" with `passwd` or add an ssh key
to /home/nixos/.ssh/authorized_keys be able to login.
+
+ If you need a wireless connection, type
+ `sudo systemctl start wpa_supplicant` and configure a
+ network using `wpa_cli`. See the NixOS manual for details.
'' + optionalString config.services.xserver.enable ''
+
Type `sudo systemctl start display-manager' to
start the graphical user interface.
'';
@@ -71,6 +76,7 @@ with lib;
# Enable wpa_supplicant, but don't start it by default.
networking.wireless.enable = mkDefault true;
+ networking.wireless.userControlled.enable = true;
systemd.services.wpa_supplicant.wantedBy = mkOverride 50 [];
# Tell the Nix evaluator to garbage collect more aggressively.