cinnamon-ublue

Fedora bootc/Universal Blue style image using Cinnamon, built with BlueBuild.

Note

This is not an official Universal Blue image. It is built from official and trusted upstream sources (the Universal Blue base image, Fedora/RPM Fusion packages, Flathub, and Homebrew). Currently, this image builds and runs successfully. The installer is not as smooth or quick as I would like (please be patient if it seems slow; it is not hung), but this is a known upstream Anaconda issue. Please review the "First Boot Summary" regarding potential startup delays during the initial boots.

This repository was developed using some directed AI assistance, although its contents have been manually tested and inspected. I believe it's important for anyone using open-source tools on GitHub to have this context before relying on them.

What You Get

• Base image: ghcr.io/ublue-os/base-main
• Cinnamon desktop (cinnamon-desktop + lightdm + slick-greeter, along with essential Mint themes and icons)
• Homebrew via Universal Blue brew OCI image
• Flatpaks via BlueBuild default-flatpaks module (system scope, Flathub)
• Automatic updates via uupd.timer (system, brew, flatpak, distrobox)
• Signed image publishing workflows in .github/workflows/

Quick Start (Installer ISO)

Use this path for most users.

1. Install bluebuild CLI (if needed). Install instructions: blue-build/cli#installation

podman run --pull always --rm ghcr.io/blue-build/cli:latest-installer | bash
bluebuild --version

2. Build installer ISO from published image:

bluebuild generate-iso \
  --variant kinoite \
  --iso-name cinnamon-ublue.iso \
  -o output \
  image ghcr.io/danathar/cinnamon:latest

Note

BlueBuild's ISO generator currently uses the community utility JasonN3/build-container-installer, not Fedora's official bootc-image-builder path documented by Fedora/bootc: https://osbuild.org/docs/bootc/.

3. Boot the ISO and install.

Detailed instructions and caveats: docs/install-iso.md.

First Boot Summary

• First graphical login is gated on one-time system Flatpak setup, so reaching LightDM can take longer when network is available.
• If first boot had no network, that setup delay may occur on a later boot after network is configured (occasional).
• For non-Anaconda install paths (raw/qcow2 disk image), time defaults to UTC; set timezone after first boot.

More details and known quirks: docs/troubleshooting.md.

Documentation

• Local builds: docs/build-locally.md
• Installer ISO install: docs/install-iso.md
• Disk image install (qcow2/raw): docs/install-disk-image.md
• Troubleshooting and known behaviors: docs/troubleshooting.md
• Automatic update/build cadence: docs/automatic-updates.md
• CI, signing, and update-path config: docs/ci-and-signing.md
• Using this repo as template or fork: docs/repo-template-or-fork.md