Multi-distro proot Linux (issue #162)
Phase 3 of the proot multi-distro work. Three new distros, a dedicated Desktop install/manage surface, and a robust per-phase OS installer with durable diagnostics.
New distros
- Debian 12 (Bookworm) — APT-based rootfs from the proot-distro release artefacts.
- Arch Linux ARM — pacman-based, rolling-release. First-launch hook regenerates the
en_US.UTF-8locale. - Void Linux (glibc, aarch64) — xbps-based, with an in-tree bootstrap hook that bypasses Void's circular self-update inside proot. Xfce4 / Openbox installs are tagged Experimental — see Void note below.
All four distros (Alpine, Debian, Arch, Void) coexist side-by-side under proot/rootfs/<distroId>/. Switch active distro from Desktop → Manage. Existing Alpine installs are migrated to proot/rootfs/alpine-3.21/ on first launch with no data loss.
Desktop tab consolidation
- The distro picker + DE install / start / stop UI moved from the Connections topbar dialog into the top-level Desktop tab. Tap the Manage icon in the TopAppBar to switch between Sessions (running VNC / RDP / Wayland) and Manage views. Empty Sessions state defaults to Manage.
- The Connections topbar's Local Shell and Desktops icons are gone. Local shells are added through the normal Connection + → LOCAL flow.
Install pipeline
- Per-DE VNC port override. Install dialog exposes the VNC port (default = next free 5901+N, range 5901–5999). Persists per (distro, DE) pair.
- Install button gated on rootfs Ready. No more taps that appear to do nothing while the rootfs is still being unpacked.
- Per-phase install attribution. Failures surface a chip naming the layer that broke (Download, Extract, Bootstrap hook, Baseline, Packages, VNC config) rather than collapsing into a generic "install failed".
- Durable Room-backed install log at Settings → View PRoot install log. Survives logcat rotation and process restarts.
MCP agent endpoint
- Foreground-service binding. The MCP HTTP endpoint now stays alive while Haven is backgrounded by pinning to the existing
specialUseFGS via aForegroundKeepAlivecontributor. Pre-rc12 the agent would drop within seconds of backgrounding. - Eight new MCP tools for driving the proot pipeline directly:
inspect_proot,list_distros,list_desktop_environments,install_distro,delete_distro,install_desktop,uninstall_desktop,get_proot_install_log. Read tools have no consent prompt; write tools each prompt per call.
Bug fixes
- step-ca OIDC discovery URL normalisation (#133, dionorgua). Authentik provisioners configured with an issuer URL (not a full
.well-known/openid-configurationURL) inconfigurationEndpointno longer fail bootstrap with HTTP 404. - CI release pipeline unblocked. rc12 / 13 / 14 each built APKs locally but their Release CI failed silently because the
SessionManagerRegistryunit test was missing thekeepAlivesparameter I added in rc12. rc15 onwards have green Release CI.
Void note
Void's Xfce4 / Openbox are tagged Experimental in the install dialog. The CLI environment works fully (rootfs + baseline complete). The X11 install path completes end-to-end after matching termux/proot-distro's exact proot flag set — the missing /dev/std{in,out,err} bindings, /dev/urandom→/dev/random, fake /proc/{loadavg,stat,uptime,version,vmstat}, --link2symlink --kill-on-exit --root-id, and /usr/bin/env -i clean env were what caused fontconfig pre-INSTALL to fail with ENOENT for ten RCs. Phase 4 adds nested wlroots compositors (Sway / Hyprland / niri / wayvnc) which is the cleaner graphical path on Void.
What's queued for v5.39
- Per-phase retry self-repair. Hook / baseline / extract failures gain a "Retry this step" affordance.
- Phase 4 nested compositors — Sway / Hyprland / niri via headless wlroots +
wayvncon the same VNC tab the X11 DEs already use. - Phase 5 (stretch) — KDE Plasma 6, GNOME, JSON-manifest catalog.