wrolpi-bootstrap.service is `WantedBy=multi-user.target` and `Before=` the wrolpi-api/app/kiwix/controller services, but had no ordering constraint against lightdm. Systemd was free to start lightdm in parallel with bootstrap, so XFCE autologin would land before bootstrap had written /tmp/wrolpi-firstboot-summary.txt — and the wrolpi-firstboot-notify autostart would fire, find no summary, and exit silently. On the live test this manifested as the user seeing the desktop come up immediately but never seeing the welcome zenity dialog. The notify script's own log confirmed the timing race: ===== Mon May 25 08:01:46 PM UTC 2026 invoked ... ===== no summary file at /tmp/wrolpi-firstboot-summary.txt — nothing to do bootstrap was still in the middle of `pg_createcluster` at 20:01:46 and didn't write the summary file until ~20:01:48. Adding `Before=display-manager.service lightdm.service` makes systemd wait for bootstrap to complete before bringing up the display manager. Tested live by logging out + back in on the running ISO (re-firing autostart with the summary already in place) — the zenity dialog appeared. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| config | ||
| files | ||
| build.sh | ||
| README.md | ||
Debian Live Config
Build a bootable amd64 ISO that boots into a full WROLPi system on any x86 PC. Users can run WROLPi directly off the USB (a persistence partition is created on the first boot so the database and media directory survive reboots) or install to disk via the Calamares launcher on the desktop.
The chroot-phase build is identical for both modes; the resulting squashfs is what runs in live mode AND what Calamares copies onto the target disk.
See https://live-team.pages.debian.net/live-manual/html/live-manual/index.en.html
Build
sudo ./build.sh # build from 'release' branch
sudo ./build.sh -b master # build from a specific branch
Requires Debian / Ubuntu with live-build installed. The resulting ISO is
written to this directory as WROLPi-v${VERSION}-amd64.iso.
Flash with Etcher, Rufus, Raspberry Pi Imager, or:
sudo dd if=WROLPi-v${VERSION}-amd64.iso of=/dev/sdX bs=4M status=progress conv=fsync
Layout on disk
The drive carries everything WROLPi needs. Postgres data lives alongside the user's library so a drive moved between hosts keeps its full state:
/media/wrolpi/
videos/ ← user-facing media
archives/
zims/
map/
tags/
config/
wrolpi.yaml
controller.yaml
fstab.yaml
ssl/
postgresql/
data/ ← bind-mounted to /var/lib/postgresql
config/ ← bind-mounted to /etc/postgresql
Implementation status
- Phase 1 — merged live + chroot config: Single
debian-live-config/produces a Debian Live ISO with the full WROLPi stack, XFCE auto-login aswrolpi, persistence partition created on first boot. - Phase 2 — Debian Installer: Standard
debian-installerbundled vialb config --debian-installer live --debian-installer-gui true. GRUB exposes "Live", "Install", and "Graphical Install" entries. Live boots into WROLPi; Install/Graphical Install copy the running squashfs onto the target disk via Debian'slive-installerflow. (We previously tried Calamares-as-the-installer; the XFCE desktop-icon click path proved unreliable in the wrolpi auto-login session and the upstream d-i path is better-tested.) - Release: CI on tag, hosting, wrolpi.org docs.