docs: configure how to use wifi in installer

Sponsored-by: author

1 files changed, 30 insertions, 0 deletions

diff --git a/README.md b/README.md
index 8976822..3e94a8e 100644
--- a/README.md
+++ b/README.md
@@ -337,6 +337,36 @@ No. Use whatever you like once you've installed a system with **v-i**
 and booted it. **v-i** itself uses Ansible, because that was easy for
 the author to use.
 
+## Can I use wifi?
+
+The installer image has all the wifi firmware packages in Debian and
+`iwd` installed, but does not automatically connect to a wifi network.
+To connect:
+
+~~~sh
+iwctl station wlan0 get-networks
+iwctl stations wlan0 connect Valkama
+~~~
+
+The first command lists available networks. The second one connects to
+a specific one. WPA2 with pre-shared keys (passwords) is supported.
+
+`iwctl` and `iwd` remember the network you've connected to, and will
+connect to one automatically in the future after booting.
+
+To avoid having to connect manually even once, you can add the
+following lines to the `configure-installer` (or `write-config.sh`)
+configuration file:
+
+~~~yaml
+wifi_name: Valkama
+wifi_password: notopen
+~~~
+
+The installed system is plain Debian, and you can configure it to
+support wifi as you would any other Debian system. The `v-i` installer
+does not copy over the wifi credentials to the installed system.
+
 ### I'd like to use v-i, but I need changes
 
 If you can make the changes yourself, go ahead: this is free and open