History

Daniel Maksymilian Syrnicki a535debf2e Some checks are pending CI / lint (push) Waiting to run Details CI / test (push) Waiting to run Details CI / validate-json (push) Waiting to run Details CI / markdown-links (push) Waiting to run Details feat: walking-skeleton live ISO that boots into the Flask wizard iso/build.sh runs mkarchiso inside a privileged archlinux container, overlays our customizations onto Arch's stock releng profile (systemd unit that launches Flask on 0.0.0.0:5000, the webinstaller under /opt/furtka, extra packages for python/flask/avahi), and drops a hybrid BIOS/UEFI ISO in iso/out/. Verified end to end: Proxmox VM (OVMF, Secure Boot off) boots the ISO, DHCP's onto the LAN, and serves screens 1-3 of the existing wizard at http://<vm-ip>:5000/install/step1. This is the first point at which Furtka is something you can run instead of something you can read about. Two known drive-list bugs surfaced while testing (/dev/loop0 and /dev/sr0 appear as install targets) — captured in the README roadmap. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>		2026-04-13 23:55:58 +02:00
..
overlay	feat: walking-skeleton live ISO that boots into the Flask wizard	2026-04-13 23:55:58 +02:00
build.sh	feat: walking-skeleton live ISO that boots into the Flask wizard	2026-04-13 23:55:58 +02:00
README.md	feat: walking-skeleton live ISO that boots into the Flask wizard	2026-04-13 23:55:58 +02:00

README.md

Live ISO build

Builds a bootable Arch-based live ISO that auto-starts the Flask webinstaller from ../webinstaller/ on boot. User plugs in a USB, boots, and the installer wizard comes up on http://<vm-ip>:5000.

Directly runnable; CI integration comes later once the build is stable.

Run a build

Needs a host with Docker. Disk space required: ~15 GB scratch during the build, ~1.5 GB for the final ISO.

./iso/build.sh

Output ISO ends up in iso/out/furtka-<date>-x86_64.iso. Around 3–10 min on a 4-core VM. First run is slower because it pulls archlinux:latest and all packages from upstream.

The script re-execs itself inside a privileged archlinux:latest container. That's so mkarchiso has root + loop-mount access without polluting the host — Ubuntu hosts don't ship archiso natively anyway.

What gets baked in

The build starts from Arch's stock releng profile (the same one used to build the official Arch ISO), then overlays our customizations from overlay/:

Overlay file	Effect
`overlay/packages.extra`	Appended to the package list. Adds `python`, `python-flask`, `avahi`, `nss-mdns`
`overlay/profiledef.sh`	Appended to `profiledef.sh`. Renames the ISO to `furtka-*` with a dated version
`overlay/airootfs/opt/furtka/`	Directory where `webinstaller/` is copied at build time
`overlay/airootfs/etc/systemd/system/`	Contains `furtka-webinstaller.service` + a symlink into `multi-user.target.wants/` so it auto-starts on boot

The systemd service runs flask --app app run --host 0.0.0.0 --port 5000 under /opt/furtka. The 0.0.0.0 binding is important — the Flask default is localhost-only, which wouldn't be reachable from another machine on the LAN.

mDNS (proksi.local) via avahi is installed but not yet wired. First milestone is just "boot → browser → wizard at raw IP". Naming comes next.

Test flow

Build: ./iso/build.sh
Copy the ISO to your Proxmox host's ISO storage (typically /var/lib/vz/template/iso/)
Create a VM with:
- 2 vCPU, 4 GB RAM, 20 GB disk (empty)
- CD-ROM attached with the Furtka ISO
- Boot order: CD before disk
- Network: same bridge as your LAN, DHCP
Start the VM. Wait ~30 s for boot.
Find its IP in Proxmox's VM summary (or your router's DHCP table)
Open http://<vm-ip>:5000 — the existing 3-screen wizard should be there

Known rough edges