From a3618b1902b2ebcbaedc64cde27f3f01a335b5f2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?L=C3=A9ana=20=E6=B1=9F?= <leana.jiang+git@icloud.com>
Date: Sat, 1 Nov 2025 18:19:35 +0800
Subject: [PATCH] README: document how to install for raspberry pi

---
 README.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/README.md b/README.md
index 402fc97f..7da3091b 100644
--- a/README.md
+++ b/README.md
@@ -36,6 +36,23 @@ This repo is managed with Nix + GNU stow
   # profit
   ```
 
+## Installation for Raspberry Pi
+Raspberry Pi uses the same configuration as the installer.
+The `(modulesPath + "/installer/sd-card/sd-image-aarch64.nix")` allows this.
+
+- Build the image `nixosConfigurations.<name>.config.system.build.sdImage`.
+  Disable stuff like Lix to build this.
+  You might want to use raw password once so you don't have agenix decryption
+  problem while trying to have wpa_supplicant have the right passwords.
+
+- Burn the image to the sd card.
+  ```bash
+  zstdcat result/sd-image/nixos-image-sd-card-<hash>-aarch64-linux.img.zst |
+        doas dd of=/dev/sdb status=progress
+  ```
+
+- profit
+
 # Pitfalls
 ## `users.mutableUsers`
 NEVER set this to true without declaratively setting the passwords.