Dakota Live ISO#
| Variant | Download | Checksum | Size | Published (UTC) | Validation | Last 3 builds |
|---|---|---|---|---|---|---|
dakota | โฌ dakota-live-latest.iso | checksum a163b05eโฆ | 3.95 GiB | 2026-08-01 16:57 | run #233 | b1 ยท b2 ยท b3 |
Builds the bootable UEFI live ISO from Dakota images.
The ISO boots the NVIDIA variant live and embeds the OCI image in an offline store
inside the squashfs so the target OS can be installed on any hardware without a network pull.
Variants#
| Variant | Base image | Bootloader | Composefs | State |
|---|---|---|---|---|
dakota | ghcr.io/projectbluefin/dakota-nvidia:stable | systemd-boot | yes | active โ built, tested, and published daily |
utah | ghcr.io/projectbluefin/utah:stable | grub2 | no | active โ built and published monthly (8th, 04:00 UTC) via build-iso-utah.yml |
bluefin | ghcr.io/projectbluefin/bluefin-nvidia:stable | grub2 | no | retired (#228) โ matrix entry disabled |
bluefin-lts-hwe | ghcr.io/projectbluefin/bluefin-lts-hwe-nvidia:stable | grub2 | no | retired (#228) โ matrix entry disabled |
This repo ships the Dakota and Utah live ISOs. Bluefin and Bluefin LTS HWE
variants are retired (#228) from CI builds and release promotion. Their offline configs
remain intact in live/src/ โ see docs/variants.md for revival steps.
The Dakota ISO embeds the NVIDIA variant as the offline store; non-NVIDIA hardware
auto-rebases on the first bootc upgrade after installation. Utah uses ghcr.io/projectbluefin/utah:stable
directly for both live and payload, so an installed system tracks :stable.
How it works#
The build uses three steps:
live/Containerfileโ a 3-stage build that pulls the Dakota NVIDIA image, creates a live
user, configures GDM autologin, installs Flatpaks from Flathub, and drops in the installer config.scripts/build-live-squashfs.shโ squashes the payload image to one layer, imports it into
a VFS containers-storage tree inside the squashfs root, then callsmksquashfs. The OCI store
travels inside the squashfs โ no separatestore.squashfs.img.live/src/build-iso.shโ assembles the final ISO with the live squashfs and boot files.
The ISO layout:
- EFI/efi.img โ FAT32 ESP with systemd-boot, kernel, and initramfs
- LiveOS/squashfs.img โ squashfs of the full live rootfs (NVIDIA variant) + embedded VFS OCI store
- El Torito UEFI entry (no-emulation mode) pointing to the ESP image
At boot, dmsquash-live mounts the squashfs and creates an overlayfs so the live environment is
fully writable. The embedded VFS store at /var/lib/containers/storage lets the installer deploy
Dakota without a network pull.
Requirements#
| Tool | Notes |
|---|---|
podman | Rootless works; needs --cap-add sys_admin for the live env build |
skopeo | Copy images into the offline store |
cosign + jq | Verify the cosign signature of ghcr images before they are built into the ISO (scripts/verify-image-signature.sh fetches a pinned cosign if absent) |
just | Task runner โ cargo install just or distro package |
KVM + qemu-system-x86_64 | For local boot testing on amd64 only |
| OVMF firmware | edk2-ovmf (Fedora/RHEL) or ovmf (Debian/Ubuntu) โ amd64 |
Disk space: The build needs ~22 GB free:
- ~4 GB for the squashed OCI image
- ~6 GB for the VFS import (single layer)
- ~6 GB for the squashfs staging tree
- ~5 GB for the final ISO
By default, output goes to ./output/. If /tmp is a small tmpfs on your machine, override with just output_dir=/path/with/space iso-sd-boot dakota.
Building#
# Clone the repo
git clone https://github.com/projectbluefin/dakota-iso
cd dakota-iso
# Full build โ live env container + ISO assembly
just iso-sd-boot dakota
# Override output directory (if ./output/ is on a small filesystem)
just output_dir=/var/data/iso-output iso-sd-boot dakota
The build takes 20โ40 minutes depending on your internet connection โ the Flatpak install step downloads ~2 GB from Flathub.
Output: output/dakota-live.iso (~4.3 GB)
Build stages#
just container dakota # Build the live environment container
just iso-sd-boot dakota # Full end-to-end build (runs container + assembles ISO)
Adding a custom build#
The justfile accepts any variant directory with a payload_ref file:
mkdir my-variant
echo 'ghcr.io/projectbluefin/my-variant:latest' > my-variant/payload_ref
just iso-sd-boot my-variant
The live/Containerfile accepts a TARGET build-arg (defaulting to dakota-nvidia). The
justfile reads <target>/payload_ref and passes the target name as TARGET. Installer
configs are patched at build time to reference the correct image.
Every ghcr.io/projectbluefin/* image the build consumes (the live base and the
payload_ref) must carry a keyless cosign signature from the CI of the repository that owns it
(utah* โ projectbluefin/utah, dakota* โ projectbluefin/dakota, bluefin* โ
projectbluefin/bluefin, bluefin-lts* โ projectbluefin/bluefin-lts);
scripts/verify-image-signature.sh verifies it and pins the build to the verified
digest. An image with no entry in its signing_repository() map is refused. just container verifies the live base unconditionally, so a variant's
registry file must stay projectbluefin โ other registries are refused.
Testing#
Serial console (headless, CI-friendly)#
Boots the ISO in QEMU with serial console output. Watch for Started gdm.service to confirm the live environment reached GDM.
just boot-iso-serial dakota
# Exit: Ctrl-A then X
With a graphical display (VNC)#
qemu-system-x86_64 \
-m 4096 -accel kvm -cpu host -smp 4 \
-drive if=pflash,format=raw,readonly=on,file=/usr/share/edk2/ovmf/OVMF_CODE.fd \
-drive if=pflash,format=raw,file=/tmp/ovmf-vars.fd \
-cdrom output/dakota-live.iso \
-vnc 127.0.0.1:0
# Connect your VNC client to localhost:5900
In libvirt / virt-manager#
The recommended way to test debug ISOs with SSH access:
# Build a debug ISO first (enables SSH: user=liveuser, pass=live)
just debug=1 output_dir=output iso-sd-boot dakota
# Launch in libvirt โ waits for DHCP lease and prints the SSH command
just boot-libvirt-debug dakota
The recipe creates an 8 GiB RAM VM with a 64 GiB install disk on the default libvirt network. Once the guest boots, it prints:
========================================
SSH ready:
ssh liveuser@192.168.122.x
password: live
========================================
Cleanup:
sudo virsh destroy dakota-debug && sudo virsh undefine dakota-debug --nvram
For production ISOs (without SSH), use the manual virt-install approach:
sudo cp output/dakota-live.iso /var/lib/libvirt/images/dakota-live.iso
sudo virt-install \
--name dakota-live \
--memory 4096 --vcpus 4 \
--boot loader=/usr/share/edk2/ovmf/OVMF_CODE.fd,loader.readonly=yes,loader.type=pflash,nvram.template=/usr/share/edk2/ovmf/OVMF_VARS.fd \
--cdrom /var/lib/libvirt/images/dakota-live.iso \
--disk size=50,format=qcow2 \
--graphics vnc,listen=127.0.0.1 \
--os-variant generic \
--tpm none \
--noautoconsole
virsh domdisplay dakota-live
# Connect to vnc://127.0.0.1:0 (port 5900)
Installer configuration#
The installer is pre-configured to install Dakota. Configuration lives in live/src/etc/bootc-installer/:
| File | Purpose |
|---|---|
images.json | Locks the image catalog to Dakota โ the installer shows only one choice |
recipe.json | Sets distro branding (distro_name, distro_logo), tour slides, and install steps |
Both files are read by org.bootcinstaller.Installer from /etc/bootc-installer/ at runtime.
images.json โ catalog entry#
{
"name": "Dakota",
"imgref": "ghcr.io/projectbluefin/dakota:latest",
"bootloader": "systemd",
"filesystem": "btrfs",
"composefs": true,
"needs_user_creation": false,
"flatpak_var_path": "state/os/default/var"
}
Key fields for Dakota:
bootloader: "systemd"โ installs systemd-boot, not GRUBcomposefs: trueโ enables composefs backendflatpak_var_pathโ where the installer places Flatpak data on the installed systemneeds_user_creation: falseโ GNOME Initial Setup handles user creation on first boot
Troubleshooting#
ISO fails to boot (UEFI says "no bootable device" or CDROM code 0009)
The El Torito entry must be in no-emulation mode. This is set by -no-emul-boot in the xorriso command in build-iso.sh. Do not remove it.
Flatpak build fails with O_TMPFILE error
This happens when building inside a container on an overlayfs mount. The fix (export TMPDIR=/dev/shm) is already in build.sh โ /dev/shm is always a real tmpfs that supports O_TMPFILE.
Build runs out of disk space
The default ./output/ directory needs ~22 GB free. If /tmp or your home directory is on a small filesystem, use a larger path:
just output_dir=/var/data/iso-output iso-sd-boot dakota
openh264 warning during Flatpak install
Warning: Failed to install org.freedesktop.Platform.openh264
This is harmless โ openh264 requires user namespaces which aren't available inside Podman builds. The ISO functions correctly without it.