Skip to content
/ myKinoiteNightly Public template
forked from blue-build/template

Template for making your own Kinoite Nightly OS image with Universal Blue features

License

Notifications You must be signed in to change notification settings

whelanh/myKinoiteNightly

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

cbcd91ade598d3c94aaf15b264d952db4f590a9a

myKinoiteNightly   bluebuild build badge

The leading edge of Fedora and KDE...with the safe rollback option built into Kinoite.

See the BlueBuild docs for quick setup instructions for setting up your own repository based on this template.

💽 My Custom Image

Custom[@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

⏭️ Changes

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

Additional available ujust commands

  • 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 Flatpaks
  • ujust remove-dev-flatpaks - Remove all development Flatpaks (keeps user data)
  • ujust list-dev-flatpaks - Show installation status of all development Flatpaks
  • ujust install-homebrew - Install Homebrew (brew)
  • ujust install-aurora-brew-bundle - Install Universal Blue's Aurora brew bundle
  • ujust 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 after nix-prep reboot)
  • ujust uninstall-nix - Remove all Nix packages and uninstall Nix completely
  • ujust undo-nix-prep - Undo nix-prep configuration and restore system to pre-Nix state (requires reboot)

NVIDIA

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-modules
  • kernel-modules-extra
  • linux-firmware
  • mesa-dri-drivers
  • xorg-x11-drv-nouveau
  • libdrm

Cosmic DE

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

🛠️ Installation

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

Nix Install

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-nix

The 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.

Uninstalling Nix

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 automatically

The 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.conf

Install Nix

curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | \
    sh -s -- install ostree --no-confirm --persistence=/var/lib/nix

Add Nix Unstable

nix-channel --add https://nixos.org/channels/nixpkgs-unstable nixpkgs
nix-channel --update

Install Home-Manager

nix-channel --update
nix-shell '<home-manager>' -A install

Configure 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 switch

ISO

If 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.

Verification

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

🙏 Gratitude

I 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.

About

Template for making your own Kinoite Nightly OS image with Universal Blue features

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages

  • Just 67.7%
  • Makefile 16.2%
  • Shell 16.1%