From 6919ca10528e0afecd1ef1958928947e7f6f77ee Mon Sep 17 00:00:00 2001 From: Lars Wirzenius Date: Sat, 22 Jul 2023 12:17:50 +0300 Subject: docs: configure how to use wifi in installer Sponsored-by: author --- README.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) 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 -- cgit v1.2.1