A custom bootc image: Fedora Kinoite with
NVIDIA, gaming and light development tooling, built on
ghcr.io/ublue-os/kinoite-main plus ublue's NVIDIA driver layer.
ghcr.io/abirkel/vespera:latest
| Candidate | Verdict |
|---|---|
ublue-os/kinoite-main + akmods-nvidia-open |
Chosen. Kinoite + a Secure-Boot-signed matching kernel + negativo17 codecs. build_files/nvidia.sh adds nvidia-open and the full 32-bit driver stack with ublue's own installer, the same way the retired kinoite-nvidia did. |
ublue-os/kinoite-nvidia |
Was the base until ublue stopped building it on 2026-11-07 (ublue-os/main#3075). |
blue-build/base-images NVIDIA |
Signs the kernel with its own key (new MOK), auto-applies updates, drops the negativo17 repo and ublue's signing policy. |
bazzite / bazzite-nvidia-open |
Replaces Discover with Bazaar, masks the appstream cache refresh, overrides branding, defaults and the update stack. Undoing all that is more work than adding to Kinoite. |
aurora-dx |
GNOME-adjacent developer focus; the DX layer is mostly unwanted here. |
fedora/fedora-kinoite |
Means owning the NVIDIA kmod signing chain. |
The base ships Fedora's kernel rebuilt and signed with ublue's MOK, which is what lets prebuilt out-of-tree modules load under Secure Boot. Do not swap the kernel — that breaks the signing chain and every kmod with it.
Containerfile base ARGs, akmods mounts, one RUN, then bootc lint
Justfile just check, build, rechunk, disk, gen-keys
cosign.pub public signing key, baked into the image
build_files/
nvidia.sh NVIDIA driver + initramfs (runs before build.sh)
build.sh runs [0-9][0-9]-*.sh in glob order
lib/common.sh log/warn/die, retry, fetch, copr_install, repo_install
00-dnf-policy.sh install_weak_deps=False (must be first)
10-packages-fedora.sh Fedora packages, one transaction
20-packages-thirdparty.sh negativo17, Terra, COPRs, ScopeBuddy, cicpoffs
30-kmods.sh v4l2loopback (akmods), yeetmouse
40-fonts.sh Nerd Fonts, core fonts
50-flatpaks.sh validates the preinstall.d declarations
60-system-config.sh system_files/, groups, samba, /etc hygiene
70-services.sh systemd unit state
80-image-info.sh image-info.json; asserts branding is stock
85-signing.sh cosign key + registries.d + policy.json
99-cleanup.sh repo state, sanity checks, /var and /boot cleanup
system_files/ copied to / verbatim (rsync -aK)
disk_config/{disk,iso-kde}.toml bootc-image-builder configs
.github/workflows/build.yml build, rechunk, sign, push, attest
.github/workflows/build-disk.yml ISO / qcow2 / raw
.github/renovate.json5 digest pinning
just gen-keys
gh secret set SIGNING_SECRET < cosign.key
git add cosign.pub
shred -u cosign.keyjust check # syntax, shellcheck, yaml, toml, layout — what CI runs first
just build # full local build (~40 GB free)
just build-fast # skips MS fonts and the yeetmouse kmod
just rechunk # split into per-package layers (see Update download size)
just diff-base # package diff against kinoite-mainsudo bootc switch --enforce-container-sigpolicy ghcr.io/abirkel/vespera:latest
# or build media:
just disk isojust disk iso # anaconda-iso, disk_config/iso-kde.toml
just disk qcow2 # disk_config/disk.toml
just run-vm # boot the qcow2 to smoke-testor run the Build disk images workflow manually.
- Log out and back in once.
ublue-system-setup.serviceadds the account tolibvirt,plugdevandgamemode; group membership only applies to new sessions. - Flatpaks install in the background via
vespera-flatpak-setup.service—journalctl -u vespera-flatpak-setup. ujust image-status— image ref, NVIDIA driver and kmod state, virt sockets, podman, whether each out-of-tree kmod matches the booted kernel, all four Discover backends.ujust check-overlaysconfirms Flatpak games get GPU acceleration and that the layer branch still matches their runtime.ujust check-ntsyncconfirms the ntsync device is present and 0666.ujust setup-lactfor GPU fan curves.- Shell is unchanged (bash).
zshis installed with fish-like plugins wired up in/etc/skel/.zshrc;chsh -s /usr/bin/zshto switch. Existing accounts do not get/etc/skel— copy the file across by hand.
Help recipes: ujust help-smb, help-iphone, help-audio, help-gamescope.