See the BlueBuild docs for quick setup instructions for setting up your own repository based on this template.
[@11/16/2025 -- I've temporarily changed image to Kinoite rawhide because Nightly hasn't been updated for awhile. To check status see: https://quay.io/repository/fedora-ostree-desktops/kinoite-nightly?tab=tags
This repository builds a custom Fedora Kinoite image based on the nightly rawhide build:
Image base: quay.io/fedora-ostree-desktops/kinoite-nightly:rawhide
The nightly Kinoite build images use the COPR solopasha git repos for the latest in-development KDE and KDE-gear packages. See https://tim.siosm.fr/blog/2023/01/20/introducing-kinoite-nightly-beta/ for further details. A number of Universal Blue packages are included in order to provide some of the features of a UBlue "dx" experience. See /recipes/recipe-nvidia.yml file for details on what I've added.
Some custom ujust 'recipes' are provided to install homebrew, Universal Blue's Aurora brew bundle, and a curated list of flatpaks if desired. See /files/system/usr/share/ublue-os/just/60-custom.just for the list of flatpaks. Also, if interested in Nix, automated ujust commands are available to simplify the installation process (see below for more details).
ujust auto-setup-flatpaks- Automatically install all development Flatpaks on first log in (This is disabled currently)ujust install-dev-flatpaks- Manually install all development Flatpaksujust remove-dev-flatpaks- Remove all development Flatpaks (keeps user data)ujust list-dev-flatpaks- Show installation status of all development Flatpaksujust install-homebrew- Install Homebrew (brew)ujust install-aurora-brew-bundle- Install Universal Blue's Aurora brew bundleujust install-fonts- Install additional fonts (from Aurora)ujust add-user-to-dx-group- Add user to additional dev groups (from Aurora)ujust nix-prep- Prepare system for Nix installation (requires reboot)ujust install-nix- Install Nix with ostree support, nixpkgs unstable channel, and Home-Manager (run afternix-prepreboot)ujust uninstall-nix- Remove all Nix packages and uninstall Nix completelyujust undo-nix-prep- Undo nix-prep configuration and restore system to pre-Nix state (requires reboot)
This image includes a set of packages that should detect your NVIDIA GPU and use the appropriate driver (newer NVIDIA GPUs that can use the nouveau driver).
kernel-moduleskernel-modules-extralinux-firmwaremesa-dri-driversxorg-x11-drv-nouveaulibdrm
For those interested in the Cosmic desktop as an alternative login option, I've also added ryanbex/cosmic-epoch COPR repo and cosmic-desktop to the installed package list. If you want a pure Cosmic rawhide image, this project also builds a ghcr.io/whelanh/cosmic-latest-ublue:latest image which you can rebase to instead. It also has all of the custom ujust recipes and added packages of the kinoite-nightly image. See /recipes/recipe-cosmic.yml
Warning
This is an experimental feature, try at your own discretion.
To rebase an existing atomic Fedora installation to the latest build:
-
First rebase to the unsigned image, to get the proper signing keys and policies installed:
rpm-ostree rebase ostree-unverified-registry:ghcr.io/whelanh/kinoite-nightly-ublue:latest -
Reboot to complete the rebase:
systemctl reboot -
Then rebase to the signed image, like so:
rpm-ostree rebase ostree-image-signed:docker://ghcr.io/whelanh/kinoite-nightly-ublue:latest -
Reboot again to complete the installation
systemctl reboot
The latest tag will automatically point to the latest build. That build will still always use the Fedora version specified in recipe.yml (which is the nightly kinoite:rawhide image).
To install Nix with ostree support, nixpkgs unstable channel, and Home-Manager, use the provided ujust commands:
ujust nix-prep
# System will reboot automatically
ujust install-nixThe nix-prep command prepares your system by configuring composefs and transient root, then automatically reboots. After the reboot, install-nix installs Nix with ostree support and sets up Home-Manager.
To completely remove Nix and restore your system to its pre-Nix state:
ujust uninstall-nix
# After Nix is uninstalled, undo the system preparation:
ujust undo-nix-prep
# System will reboot automaticallyThe uninstall-nix command removes all installed Nix packages (installed via nix profile install) and uninstalls Nix completely. The undo-nix-prep command removes the composefs and transient root configuration, restoring your system to its original state, then automatically reboots.
Manual Installation Instructions (if preferred)
These steps are automated by the ujust commands above, but can be run manually if needed (following instructions from https://github.com/DXC-0/Nix-Dotfiles):
Preparation
sudo tee /etc/ostree/prepare-root.conf <<'EOL'
[composefs]
enabled = yes
[root]
transient = true
EOL
rpm-ostree initramfs-etc --reboot --track=/etc/ostree/prepare-root.confInstall Nix
curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | \
sh -s -- install ostree --no-confirm --persistence=/var/lib/nixAdd Nix Unstable
nix-channel --add https://nixos.org/channels/nixpkgs-unstable nixpkgs
nix-channel --updateInstall Home-Manager
nix-channel --update
nix-shell '<home-manager>' -A installConfigure Home-Manager (optional)
git clone https://github.com/DXC-0/Nix-Dotfiles.git [MORE LOGICALLY, YOUR OWN FORK OF THIS REPO]
cd Nix-Dotfiles
mkdir -p $HOME/.config/home-manager
mv * $HOME/.config/home-manager
home-manager switchIf build on Fedora Atomic, you can generate an offline ISO with the instructions available here. These ISOs cannot unfortunately be distributed on GitHub for free due to large sizes, so for public projects something else has to be used for hosting.
These images are signed with Sigstore's cosign. You can verify the signature by downloading the cosign.pub file from this repo and running the following command:
cosign verify --key cosign.pub ghcr.io/whelanh/myKinoite-amd:latestI sincerely appreciate all of the hard work by BlueBuild, Fedora, Universal Blue and solopasha for providing COPR KDE Git repos that make this image possible. In particular, I thank Universal Blue for their packages available on the COPR repository.