Main

A WIP common main image for all other Ublue images.

Features
Tips and Tricks
How to Install
Verification
Configuring Automatic Updates
Making your own

What is this?

You should be familiar with immutable desktops. These are Fedora-ostree 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 and user package installation
- 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

Tips and Tricks

These images are immutable, you can't, and really shouldn't, install packages like in a mutable "normal" distribution. Applications should be installed using Flatpak whenever possible (execpt for IDEs in some cases, more below). Should that not be possible, you can use distrobox to have images of mutable distributions where you can install applications normally. Want an application that is only available on Arch Linux and one that is only on Ubuntu? Well, now can have both!

Distrobox is very powerful, for example you can use to host your entire development environment completely separate from your host system. Or use it to run a container for your virtual machines.

ublue-os/base-main is also very well suited for servers, and users are expected to make full use of podman to host containers running "typical" server software i.e. nginx, caddy and others.

How to Install

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
If you are coming from an existing system it is recommended to not have any layered packages before proceeding. See the Fedora documentation for more information.
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

LXQt

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

MATE

sudo rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/mate-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

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.

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: