Add modern Raspberry Pi OS compatibility

README.md

@@ -15,3 +15,30 @@ Required hardware:
     - Raspberry Pi with WiFi
     - min 8 GB SD card
     - battery or power adapter
+
+## Installation on current Raspberry Pi OS
+
+Pivilion supports Raspberry Pi OS Bullseye, Bookworm, and Trixie. Bookworm and
+newer systems use NetworkManager automatically; Bullseye installations using
+`dhcpcd` use the legacy hostapd backend. The repository layout and the original
+commands are preserved on both backends.
+
+On a fresh Raspberry Pi OS Lite installation:
+
+```sh
+git clone https://gitlab.com/hacklab01/pivilion.git
+cd pivilion
+sudo ./install.sh
+sudo reboot
+```
+
+The installer defaults to the user that invoked `sudo`, not to a hard-coded
+`pi` account. To customize paths, startup mode, hotspot SSID, or Wi-Fi
+interface, copy `pivilion.conf.example` to `/boot/firmware/pivilion.conf` (or
+`/etc/pivilion.conf`) and edit it before installing. The hotspot is intentionally
+open and passwordless.
+
+Use `pikey` to save upstream Wi-Fi credentials, then `onion` and reboot to host
+through Tor. Use `hotspot` and reboot to run the local captive gallery at
+`http://10.1.1.1/`. HTTPS interception is intentionally not attempted because a
+local captive portal cannot present valid certificates for arbitrary sites.