LordOS — a free, fast and secure GNU/Linux distribution based on Debian, with its own desktop environment: display server and Wayland compositor in C, a React UI engine on QuickJS, and private native apps.
C cdebiandesktop-environmentebpffirewalllandlocklinuxlinux-distributionopen-sourceprivacyquickjsraspberry-pi-5reactsecuritywaylandwayland-compositor
Raspberry Pi: LordOS kernel with Landlock (build-kernel.sh), boot switch files, verify-board; docs
Federico Pereira3ed5eb10f19b
diff --git a/docs/RASPBERRY.md b/docs/RASPBERRY.mdindex 92de3b2..364f080 100644--- a/docs/RASPBERRY.md+++ b/docs/RASPBERRY.md@@ -108,7 +108,7 @@ as they are: the fix is the kernel.what LordOS needs:```sh-# on the Pi (arm64 Debian 13), ~70–90 min per flavour on a Pi 5 with 4 cores+# on the Pi (arm64 Debian 13): about 50 min per flavour on a Pi 5 (4 cores, SD card, Active Cooler)sudo apt-get install -y --no-install-recommends build-essential bc bison flex libssl-dev libelf-dev \libdw-dev dwarves cpio kmod rsync dpkg-dev debhelper gittools/rpi/build-kernel.sh /var/tmp/lordos-kernel all # 2712 (Pi 5), v8 (Pi 4), or all@@ -143,6 +143,14 @@ tools/rpi/build-kernel.sh /var/tmp/lordos-kernel all # 2712 (Pi 5), v8 (Pi 4on, so it installs exactly like Raspberry Pi's: `kernel_2712.img`, initramfs, device trees andoverlays in `/boot/firmware`. The script checks the package carries the device trees andoverlays. Headers are built too (`linux-headers-*`), not put in the image.+ - `make` gets `LOCALVERSION=` (empty): otherwise, in a git tree that isn't at a tag, the release+ gets a trailing `+` (`…-rpi-2712+`) and the hook skips it as an unknown flavour.+ - `make dtbs_install` doesn't install `overlays/README`, which the hook copies (and fails+ without): the script adds it to the package.+ - Measured on 2026-10-18 on the Pi 5 (load 4, 40–55 °C with the Active Cooler): 2712 in 50 min,+ v8 in 49 min. `linux-image-6.18.57-lordos-rpi-2712_6.18.57-1+lordos_arm64.deb` 32 MB (vmlinuz+ 10 MB, 385 overlays) and `linux-image-6.18.57-lordos-rpi-v8_…` 33 MB; `out/SHA256SUMS` lists+ them. The v8 diff is the same three options (`-v8` → `-lordos-rpi-v8`).- **Not replaced by the archive.** `build-img.sh` installs the LordOS `.debs` from `KERNEL_DEBS`(default `/var/tmp/lordos-kernel/out`) instead of `linux-image-rpi-<flavour>`, and writes`/etc/apt/preferences.d/lordos-kernel` with priority -1 for Raspberry Pi's kernel packages of@@ -548,6 +556,9 @@ on the development machine.| EGL/GBM | `V3D 7.1.10.2`, OpenGL ES 3.1 (`eglinfo -p gbm`). LordOS's GPU path on screen not exercised (no monitor) || Video (FFmpeg CLI) | HEVC 1080p30 through `rpi-hevc-dec` (`/dev/video19`, `-hwaccel drm -hwaccel_output_format drm_prime`): 300 frames in 0.54 s with 0.12 s of CPU. Software, 4 threads: HEVC 1080p 251 fps, H.264 1080p ~420 fps (synthetic `testsrc2` clip: real content is heavier). lord-media only knows VA-API, so inside LordOS HEVC is software for now || `build-img.sh` natively on the Pi | ✅ after the key fix (above): 7 min 58 s from the SD card. `/var/tmp/lordos-rpi/out/lordos-0.7.0-rpi5-arm64.img.xz`, 500 MB (2651 MB uncompressed, system 1412 MB). Kernel 6.18.50+rpt, `kernel_2712.img`/`kernel8.img`, initramfs, 386 overlays. **The image hasn't been booted yet** (the board's only SD is the running system) |+| LordOS kernel (`build-kernel.sh all`, natively) | ✅ `6.18.57-lordos-rpi-2712` (50 min) and `6.18.57-lordos-rpi-v8` (49 min), Landlock built in; installed in a chroot: `raspi-firmware`'s hook copied `kernel_2712.img`, initramfs, device trees and 388 overlays. **Not booted yet** (the board's SD is the running system) |+| `build-img.sh` with the LordOS kernels, lord-fand and the switch files | ✅ 8 min 18 s. `lordos-0.7.0-rpi5-arm64.img.xz`, 503,485,468 bytes (2673 MB uncompressed, system 1431 MB), SHA-256 `d47778e6cb8a614b3bb104d14f808dcdf27a4a4f6f61dc50c055cccc9f5cb045`. Checked read-only: `kernel_2712.img` = our vmlinuz, `lsm=landlock,…` in `cmdline.txt`, the apt pin, SSH installed but off, `lord-fand` enabled, `verify-board` present |+| `firstboot` switch files (in a chroot of the image) | ✅ user + Wi-Fi from `lordos-user.txt` (SSID with quotes, `wifi_country` → `cmdline.txt`), `remote-desktop` with `port=5800` → `/etc/lordos/remote/config`, kept while the only account had no password, `allow=group` creates `lordos-remote`, a bad `port=99` falls back to 5673; the files are deleted |Found and fixed on the board:diff --git a/docs/ROADMAP.md b/docs/ROADMAP.mdindex a65f1f5..703b544 100644--- a/docs/ROADMAP.md+++ b/docs/ROADMAP.md@@ -490,7 +490,7 @@ Details in `MAIL.md`. Tested on VM 123 against local Dovecot, Postfix and Radica`PRIVACY.md`): read-only frame ring from `lord-media` with validated ACKs, photo/video throughthe powerbox, instant revoke; one Wayland toplevel per window, grouped in the Dock, «Newwindow» from the app and the Dock.-- [ ] **Visual polish, app by app** (before the ISO): review every native app+- [x] **Visual polish, app by app** (before the ISO; done 2026-10-18, see `docs/polish/`): review every native app(Settings, Files, Terminal, Store, Editor, Notes, Calculator, Monitor, PDF, Fonts,Emoji, Scanner, Photos, Player, Screenshots, Camera, Recorder, Passwords, Disks, Backups,Logs, Clock, Help, Mail…) following our design guide, modeled on widely used desktop human-interface conventions (`DESIGN.md`): 8 px grid,diff --git a/tools/rpi/build-kernel.sh b/tools/rpi/build-kernel.shindex db0fe84..45ef034 100644--- a/tools/rpi/build-kernel.sh+++ b/tools/rpi/build-kernel.sh@@ -2,7 +2,7 @@# build-kernel.sh — the LordOS Raspberry Pi kernel: Raspberry Pi's own kernel source and defconfig,# plus what LordOS needs that it lacks (Landlock). See docs/RASPBERRY.md, "The LordOS kernel".#-# Usage (on an arm64 Debian 13, ideally the Pi itself; ~70–90 min per flavour on a Pi 5):+# Usage (on an arm64 Debian 13, ideally the Pi itself; about 50 min per flavour on a Pi 5):# tools/rpi/build-kernel.sh [work folder] [2712|v8|all] # default /var/tmp/lordos-kernel 2712## Result: <work>/out/linux-image-<release>_<version>_arm64.deb (+ linux-headers-…), where@@ -43,7 +43,7 @@ done# raspi-firmware's kernel hook copies overlays/README along with the overlays and fails without it;# Raspberry Pi's own packages ship it, `make dtbs_install` doesn't: added to the package here.add_overlay_readme() { # .deb, kernel release- dpkg-deb -c "$1" | grep -q "usr/lib/linux-image-$2/overlays/README\$" && return 0+ dpkg-deb -c "$1" | grep -c "usr/lib/linux-image-$2/overlays/README\$" > /dev/null && return 0R="$WORK/repack"rm -rf "$R"; dpkg-deb -R "$1" "$R"install -m 644 "$SRC/arch/arm/boot/dts/overlays/README" "$R/usr/lib/linux-image-$2/overlays/README"@@ -109,10 +109,12 @@ for FL in $FLAVOURS; doecho " config diff: $(grep -c '^[<>]' "$OUT/config-$KV$LV.diff") lines ($OUT/config-$KV$LV.diff)"T0=$(date +%s)- rm -f "$WORK"/linux-*"$KV$LV"*.deb "$WORK"/linux-libc-dev_*.deb+ rm -f "$WORK"/linux-*"$KV$LV"*.deb "$WORK"/linux-libc-dev_*.deb "$WORK"/linux-lordos-rpi-"$FL"_*# bindeb-pkg leaves the .debs in the parent of the build folder ($WORK)# shellcheck disable=SC2086- make -C "$SRC" O="$B" ARCH=arm64 $CROSS -j"$JOBS" \+ # LOCALVERSION= (empty): without it setlocalversion appends "+" for a git tree that isn't at a+ # tag, giving "…-rpi-2712+", which raspi-firmware's hook doesn't recognize as a flavour+ make -C "$SRC" O="$B" ARCH=arm64 $CROSS -j"$JOBS" LOCALVERSION= \KDEB_PKGVERSION="$KV-$KREV+lordos" KDEB_SOURCENAME="linux-lordos-rpi-$FL" \KBUILD_BUILD_USER=lordos KBUILD_BUILD_HOST=lordos \bindeb-pkg > "$OUT/build-$FL.log" 2>&1 || { tail -40 "$OUT/build-$FL.log"; exit 1; }@@ -120,13 +122,14 @@ for FL in $FLAVOURS; dofor d in "$WORK/linux-image-$KV$LV"_*.deb "$WORK/linux-headers-$KV$LV"_*.deb; do[ -f "$d" ] && mv "$d" "$OUT/"done- rm -f "$WORK"/linux-libc-dev_*.deb "$WORK/linux-image-$KV$LV"-dbg_*.deb- IMGDEB=$(ls "$OUT/linux-image-$KV$LV"_*.deb)+ rm -f "$WORK"/linux-libc-dev_*.deb "$WORK/linux-image-$KV$LV"-dbg_*.deb "$WORK"/linux-lordos-rpi-"$FL"_*+ IMGDEB=$(ls "$OUT/linux-image-$KV$LV"_*.deb 2>/dev/null) || {+ echo "build-kernel.sh: no linux-image-$KV$LV package; built: $(ls "$WORK"/*.deb 2>/dev/null)" >&2; exit 1; }add_overlay_readme "$IMGDEB" "$KV$LV"# the device trees and overlays where raspi-firmware's hook looks for them- dpkg-deb -c "$IMGDEB" | grep -q "usr/lib/linux-image-$KV$LV/broadcom/bcm2712-rpi-5-b.dtb" ||+ dpkg-deb -c "$IMGDEB" | grep -c "usr/lib/linux-image-$KV$LV/broadcom/bcm27.*\.dtb" > /dev/null ||{ echo "build-kernel.sh: $IMGDEB has no device trees in /usr/lib/linux-image-$KV$LV/broadcom" >&2; exit 1; }- dpkg-deb -c "$IMGDEB" | grep -q "usr/lib/linux-image-$KV$LV/overlays/.*\.dtbo" ||+ dpkg-deb -c "$IMGDEB" | grep -c "usr/lib/linux-image-$KV$LV/overlays/.*\.dtbo" > /dev/null ||{ echo "build-kernel.sh: $IMGDEB has no overlays" >&2; exit 1; }echo " built in $(( (T1 - T0) / 60 )) min: $(basename "$IMGDEB") ($(du -h "$IMGDEB" | cut -f1))"done