Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Repository files navigation

Bazzite Blue

Build container image Lint

Bazzite with some bluesabre-flavored tweaks.
The name is a work-in-progress.

Based on the ublue-os/image-template image template.

Image Definition

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.

Added to Bazzite

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

Switch to This Image

From your bootc system, run the following command:

sudo bootc switch --enforce-container-sigpolicy ghcr.io/bluesabre/bazzite-blue

This 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.

Usage Notes

Stale-image warning

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 5

When a scheduled build on main fails, CI also opens a GitHub issue labelled build-failure. The next successful build closes it.

Making Changes

All changes go through pull requests:

  1. Iterate locally: just build builds the image with podman, and just lint runs ShellCheck (in a container if it isn't installed).
  2. 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 from latest.
  3. 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
  4. 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.

Recommended repository setting

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.

Repository Contents

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.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages