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):

Download and install Fedora Silverblue
After you reboot you should pin the working deployment so you can safely rollback
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/nani8ot/silverblue-riverblue:37

Base

Which (originally) does not come with any desktops or window managersw, but this base-riverblue comes with river and sway:

sudo rpm-ostree rebase ostree-unverified-registry:ghcr.io/nani8ot/base-riverblue: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/nani8ot/base-riverblue

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.

Configuring Automatic Updates

Warning

Disabling automatic updates is an unsupported configuration. If you reconfigure updates, you MUST be on the latest image before opening any issues.

With that said, you can individually disable which automatic update timers ublue-os/config provides with the following commands:

flatpak system: sudo systemctl disable flatpak-system-update.timer
flatpak user: sudo systemctl --global disable flatpak-user-update.timer

You can also configure automatic rpm-ostree updates by editing /etc/rpm-ostreed.conf and changing "AutomaticUpdatePolicy" to "none" or "check":

[Daemon]
AutomaticUpdatePolicy=check

Making your own

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

nani8ot/riverblue