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
Docs: the imager in RASPBERRY, ROADMAP, ARCHITECTURE, the docs index and the 0.8.4 changelog
Federico Pereirab63fb9bb66bf
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 7beb77f..7b23ff9 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -12,6 +12,36 @@ of the matching [GitHub release](https://github.com/lordbasex/LordOS/releases),## [0.8.4] - Unreleased+### Added++- **LordOS Imager.** Write LordOS to an SD card or a USB stick and have the Raspberry Pi 5 start+ ready to use: choose the device (Raspberry Pi 5, or a PC from a USB stick), the system image (the+ latest signed release, downloaded once and resumed if interrupted, or a file of your own with a+ clear warning) and the drive (only SD cards and USB drives; internal disks and the disk the+ computer runs from are never shown), then customise the first boot: computer name, language,+ time zone, keyboard, your account (only a hash of the password goes on the card), Wi-Fi (only the+ derived key), SSH with keys or a password, LordOS remote desktop (local network only), Bluetooth,+ Lord Default or Classic in light or dark with your accent, and cooling (case with a fan, active+ cooler, passive case or nothing, with a matching profile and an optional mild overclock with a+ fan). Lumo gives a tip at every step and celebrates at the end. Every official image is checked+ against the LordOS release signature before anything is erased, and every card is read back and+ compared after writing; cancelling clears the card. In English, Spanish and Portuguese, with+ keyboard navigation. See [docs/IMAGER.md](docs/IMAGER.md).+- **The LordOS Imager for other computers**: the same app for the three common desktop platforms (Tauri, about+ 6 MB), sharing the interface with the one in LordOS. Built from the source for now; signed+ downloads will come with a release.+- **First-run file on the Raspberry Pi** (`lordos-firstrun.txt` on the boot partition): read once on+ the first boot by `lordos-firstrun`, strictly validated (nothing is applied if any part is wrong),+ then overwritten and deleted. See [docs/RASPBERRY.md](docs/RASPBERRY.md), "First boot".++### Security++- The imager's privileged part is four closed actions: downloads run `curl` as the user against two+ fixed URL shapes; writing accepts only a whole removable disk whose size, model and serial are+ re-checked right before it is opened exclusively, decompresses with `xz` running as the user, and+ never writes an official image whose signature or hash doesn't match. Over 2 TiB is refused.+- Saved Wi-Fi networks may hold a derived WPA2 key (`psk=`) instead of the password.+### Changed- **Browsers with a single top bar.** Chromium and Firefox now draw their own bar, with the tabs indiff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.mdindex e7af8af..0c32158 100644--- a/docs/ARCHITECTURE.md+++ b/docs/ARCHITECTURE.md@@ -57,6 +57,7 @@ like React Native but on top of our display server.| `server/src/vault/`, `js_vault.c`, `sdk/vault.js`, `apps/passwords` | **M9** | Passwords and the system keyring: the sandboxed helper `lord-vault` (Monocypher: XChaCha20-Poly1305, Argon2id), own `.lvault` format, FIDO2/CTAP2 client, session keyring opened at login, Secret Service on D-Bus with own code (see `PASSWORDS.md`) || `server/src/net/netd.c`, `remote/netsup.c` | **M9** | `lord-netd`: the network belongs to the system. A root service started and supervised by `lord-sessiond` at boot, serving the `net-*` actions for every session (see `NETWORK.md`) || `server/src/disk/`, `js_disk.c`, `sdk/disks.js`, `apps/disks` | **M9** | Disks: listing without root (sysfs, udev database, mountinfo), our own SMART reader (ATA PASS-THROUGH over SG_IO, NVMe health log), closed `disk-*` actions, bootable USB verified with SHA-256 (see `SYSTEM.md`) |+| `server/src/imager/`, `server/src/firstrun/`, `js_imager.c`, `apps/imager`, `desktop/imager` | **0.8.4** | LordOS Imager: verified image → removable drive (`imager-*` actions, `xz` and `curl` as the user), the Raspberry Pi first-run file and its applier `lordos-firstrun`, and the same UI as a Tauri app for other computers (see `IMAGER.md`) || `server/src/mail/`, `js_mail.c`, `sdk/{mail,calendar,contacts}.js`, `apps/{mail,calendar,contacts,reminders}` | **M9** | Mail, Calendar, Contacts and Reminders: the sandboxed helper `lord-maild` (IMAP with IDLE/CONDSTORE, SMTP, CalDAV/CardDAV, OpenSSL) with no sockets of its own — `lord-server` connects only to configured servers and hands it the fd; own MIME, HTML sanitizer, iCalendar, vCard and XML parsers (see `MAIL.md`) || `server/src/backup/`, `js_backup.c`, `sdk/backup.js`, `apps/backup` | **M9** | Backups: hard-link snapshots in a lord-server thread (nice 19, idle I/O), hourly/daily/weekly retention, optional encryption with the vendored Monocypher; no root and no `admin.c` actions (see `SYSTEM.md`) || `server/src/logs/`, `js_logs.c`, `sdk/logs.js`, `apps/logs` | **M9** | Logs: our own systemd journal reader (no libsystemd), LordOS logs, system logs for admins through a closed action, live follow with inotify (see `SYSTEM.md`) |diff --git a/docs/RASPBERRY.md b/docs/RASPBERRY.mdindex 7fe8c71..e40f7fc 100644--- a/docs/RASPBERRY.md+++ b/docs/RASPBERRY.md@@ -259,6 +259,10 @@ Estimate: on x86-64 with qemu, 30–60 minutes the first time. Natively on the P### Writing it+- **LordOS Imager** (recommended; `IMAGER.md`): in LordOS (App Launcher → System) or as a small app+ for other computers. It downloads the latest release, checks its signature, writes+ and verifies the card, and prepares the first boot (computer name, language, user, Wi-Fi, SSH and+ remote desktop, appearance, cooling) in `lordos-firstrun.txt` (next section).- **Raspberry Pi Imager:** "Choose OS" → "Use custom" → the `.img.xz`, and then the card or theNVMe.- Skip Imager's OS customization (it's designed for Raspberry Pi OS; newer versions write@@ -288,6 +292,17 @@ Estimate: on x86-64 with qemu, 30–60 minutes the first time. Natively on the P`lordos-rpi-firstboot.service` runs before lord-sessiond (`/usr/lib/lordos/rpi/firstboot`) and doestwo things.+0. **The LordOS Imager's settings (0.8.4).** If the `bootfs` partition has a `lordos-firstrun.txt`,+ `/usr/lib/lordos/bin/lordos-firstrun` checks it with a strict parser and, only if all of it is+ valid, applies it once: computer name, language, time zone, keyboard, Wi-Fi country and network+ (the derived WPA2 key, never the password), the user (from a yescrypt or SHA-512 crypt hash),+ automatic login, SSH (keys only or with passwords), remote desktop (local network only),+ Bluetooth, appearance and cooling (fan profile, CPU governor, a `config.txt` block for a mild+ overclock or a lower clock). The file is then overwritten and deleted. An invalid file applies+ nothing and the steps below run as before. Format and details: `IMAGER.md`, "The first-run+ file". Tested by applying it (`--root`) to the real 0.8.3 image on a virtual USB stick; not yet+ booted on a board.+1. **Grows partition 2** to the end of the card or disk (`sfdisk -N 2`, `partx -u` and an online`resize2fs`).2. **The user**, like the installer's "User" step (`docs/ISO.md`).diff --git a/docs/README.md b/docs/README.mdindex ab36789..18b5a0f 100644--- a/docs/README.md+++ b/docs/README.md@@ -23,6 +23,7 @@ Website: [lordos.org](https://lordos.org) · Brand kit: [LORDOS-BRAND.md](LORDOS|---|---|| [ISO.md](ISO.md) | The live and installable ISO for 64-bit PCs: building, booting, final test results || [RASPBERRY.md](RASPBERRY.md) | The Raspberry Pi 5 image, our kernel with Landlock, boot switch files |+| [IMAGER.md](IMAGER.md) | LordOS Imager: writing LordOS to cards and sticks, in LordOS and on other computers, and the first-run file || [INSTALL-DEBIAN.md](INSTALL-DEBIAN.md) | Installing LordOS on an existing Debian 13 with one command || [VM-SETUP.md](VM-SETUP.md) | The development VM, step by step || [RELEASING.md](RELEASING.md) | How a release is made: changelog, tag, build, sign, SBOM and the GitHub release notes |diff --git a/docs/ROADMAP.md b/docs/ROADMAP.mdindex f804dbb..e6826ea 100644--- a/docs/ROADMAP.md+++ b/docs/ROADMAP.md@@ -668,6 +668,17 @@ Details in `MAIL.md`. Tested on VM 123 against local Dovecot, Postfix and RadicaFirefox draw their own bar by default, with LordOS's window buttons (traffic lights from LordOS'sGTK theme in Chromium), and the window menu, resize edges and snap layouts keep working. See`docs/WAYLAND.md`, "Who draws the frame".+- [x] **LordOS Imager (0.8.4)** — our own card and stick writer with a first-run experience for the+ Raspberry Pi 5, in LordOS (`apps/imager`) and as a Tauri app for other computers+ (`desktop/imager`, one UI for both): signed releases downloaded and cached with resume, only+ removable drives, verified writes (read back and compared), the first-run file+ (`lordos-firstrun.txt`: computer name, language, user, Wi-Fi with the derived key, SSH, remote+ desktop, appearance, cooling) applied once by `lordos-firstrun` on the board. See `docs/IMAGER.md`.+ - [ ] boot a card it wrote on a real Raspberry Pi 5 (applied with `--root` to the 0.8.3 image so far);+ - [ ] real sticks and cards on each desktop platform (only virtual ones so far), the Mac's+ authorized-open prompt and udisks2/polkit on a desktop Linux;+ - [ ] sign the Mac and Windows downloads (an identity to be chosen) and publish them with the release;+ - [ ] Wi-Fi scan in the desktop app; WPA3-only networks (today the board needs the password typed there).- [ ] **Settings → Appearance: "Browsers: tabs in the title bar" (0.8.4, proposal)** — one switch,on by default, that sets the browsers' own preferences for the user instead of each browser'ssettings page: