Bazzite with some bluesabre-flavored tweaks.
The name is a work-in-progress.
Based on the ublue-os/image-template image template.
This image is built atop the Bazzite Nvidia (ghcr.io/ublue-os/bazzite-nvidia:stable) image. It uses the Nvidia proprietary drivers to support the Nvidia GTX 1080 graphics card, among many others.
The image is rebuilt daily, so it picks up upstream Bazzite updates automatically.
| Package | File | Credits |
|---|---|---|
1Password (1password, 1password-cli) with Vivaldi support |
install-1password.sh | benhoman/ublue |
Inter Font Family (rsms-inter-fonts) |
install-fonts.sh | N/A |
Microsoft TrueType Core Fonts (msttcore-fonts) |
install-fonts.sh | kohega/bazzite-khg |
Ubuntu Font Family (fonts-ubuntu) |
install-fonts.sh | rpassmore/my-ublue-os |
Virtual Machine Manager (virt-manager, libvirt/QEMU) |
install-virt-manager.sh | butterflysky/butterfly-ublue |
Visual Studio Code (code) |
install-vscode.sh | ublue-os/bluefin |
| Optipng, flatpak-builder, Yakuake | install-utilities.sh | N/A |
| Signature verification policy for this image | configure-signing.sh | N/A |
| Stale-image desktop warning | install-image-age-check.sh | N/A |
Optional (disabled in build.sh)
| Package | File | Credits |
|---|---|---|
| 1Password Edge channel | install-1password.sh edge |
see above |
Brave Browser (brave-browser) |
install-brave.sh | N/A |
Insync (insync) |
install-insync.sh | ebits21/insync-distrobox |
Vivaldi Browser (vivaldi-stable) |
install-vivaldi.sh | N/A |
From your bootc system, run the following command:
sudo bootc switch --enforce-container-sigpolicy ghcr.io/bluesabre/bazzite-blueThis queues the image for the next reboot. --enforce-container-sigpolicy makes bootc refuse images that aren't signed with this repo's cosign key.
If you're switching from stock Bazzite, your current system doesn't yet know this image's signing key, so the first switch may need to drop --enforce-container-sigpolicy. After you reboot into this image, the policy is installed and later updates are verified.
A per-user timer (bazzite-blue-image-age.timer) checks the booted image's build date once a day. If the image is more than 3 days old, which usually means the daily build is failing, it shows a desktop notification. To check by hand:
systemctl --user start bazzite-blue-image-age.service
journalctl --user -u bazzite-blue-image-age.service -n 5When a scheduled build on main fails, CI also opens a GitHub issue labelled build-failure. The next successful build closes it.
All changes go through pull requests:
- Iterate locally:
just buildbuilds the image with podman, andjust lintruns ShellCheck (in a container if it isn't installed). - Open a PR from a branch in this repository. CI builds the image and publishes it as
ghcr.io/bluesabre/bazzite-blue:pr-<N>, signed and separate fromlatest. - Optionally boot it to test on real hardware:
sudo bootc switch --enforce-container-sigpolicy ghcr.io/bluesabre/bazzite-blue:pr-<N> # reboot, test, then go back: sudo bootc switch --enforce-container-sigpolicy ghcr.io/bluesabre/bazzite-blue:latest
- Merge once the "Build and push image" and "Lint" checks are green. Closing the PR deletes its
pr-<N>image.
PRs from forks and from Dependabot are built but not published.
Under Settings → Rules → Rulesets, add a ruleset for main that requires a pull request and the status checks Build and push image and Lint scripts and Justfile. Add yourself to the bypass list for emergencies.
| Path | Purpose |
|---|---|
| Containerfile | Entry point: base image, runs build.sh, then bootc container lint |
| build_files/build.sh | Calls each installer in build_files/scripts/ |
| .github/workflows/build.yml | Daily/push/PR build, rechunk, push to GHCR, cosign signing, failure issues |
| .github/workflows/lint.yml | ShellCheck and Justfile syntax |
| .github/workflows/cleanup-pr.yml | Deletes pr-<N> images when a PR closes |
| .github/workflows/build-disk.yml | Builds qcow2/ISO disk images with bootc-image-builder |
| Justfile | Local build, rechunk, VM, and lint recipes (just --list) |
For details on disk images, ArtifactHub, and the Justfile recipes, see the upstream ublue-os/image-template README.