ConcJump / ublue-main

An OCI base image of Fedora with batteries included

Main

A WIP common main image for all other Ublue images.

What is this?

These are Fedora images that have been modified with the following quality of life features:

Features

• Start with a Fedora image
• Adds the following packages to the base image:
  • Hardware acceleration and codecs
  • distrobox for terminal CLI
  • A selection of udev rules and service units
  • Various other tools: check out the complete list of packages
• Sets automatic staging of updates for the system
• Sets flatpaks to update twice a day
• Everything else (desktop, artwork, etc) remains stock so you can use this as a good starting image

How to use these:

Note: If you have an Nvidia GPU use the ublue-os/nvidia images instead

To rebase an existing Silverblue/Kinoite machine to the latest release (37):

1. Download and install Fedora Silverblue
2. After you reboot you should pin the working deployment so you can safely rollback
3. Open a terminal and use one of the following commands to rebase the OS:

Silverblue (GNOME):

sudo rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/silverblue-main:37

Kinoite (KDE)

sudo rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/kinoite-main:37

Sericea (Sway)

Fedora 38-only, recommended only for advanced users

sudo rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/sericea-main:38

Vauxite (XFCE)

sudo rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/vauxite-main:37

Base

Which does not come with any desktops or window managers:

sudo rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/base-main:37

Architecture

This image can be used as an end user desktop or as something to derive from. If you're interested in making your own:

Graph of the uBlue architecture:

Adding Applications

Edit the packages.json file with your preferred applications. Flatpak installation is a WIP.

Verification

These images are signed with sisgstore's cosign. You can verify the signature by downloading the cosign.pub key from this repo and running the following command:

cosign verify --key cosign.pub ghcr.io/ublue-os/base

If you're forking this repo you should read the docs on keeping secrets in github. You need to generate a new keypair with cosign. The public key can be in your public repo (your users need it to check the signatures), and you can paste the private key in Settings -> Secrets -> Actions.

Making your own

See the documentation on how use this image in your own projects.