Menu

Tree [2e7a71] main /
 History

HTTPS access


File Date Author Commit
 .github 2026-08-17 dependabot[bot] dependabot[bot] [155bc3] Bump actions/checkout from 4 to 7
 boot 2026-08-11 butre butre [ee0f3d] Update build workflow, complete tasks, and refa...
 current work 2026-08-16 butre butre [c4db0c] Update enable-extras.md
 files 2026-08-17 butre butre [2e7a71] Export new desktop apps; simplify container_exists
 kickstarts 2026-08-11 butre butre [44829a] Remove sigstore preinstall; add bootc switch
 modules 2026-08-13 butre butre [7179e8] Update custom-kernel.sh
 recipes 2026-08-16 butre butre [8c4d53] Add dynamic 'enable-extras' installer and docs
 .gitattributes 2026-08-06 butre butre [4ee2c9] Update .gitattributes
 .gitignore 2026-03-14 butre butre [f7b25d] Initial commit
 LICENSE 2026-03-14 butre butre [f7b25d] Initial commit
 NEWS.md 2026-08-12 butre butre [05631a] Extract NEWS section into NEWS.md
 README.md 2026-08-17 butre butre [54618b] Fix screenshot link in README.md
 TODO.md 2026-08-13 butre butre [f1408a] Update TODO.md
 cosign.pub 2026-06-19 butre butre [312edc] Update cosign.pub

Read Me

screenshot of desktop and fastfetch

bluebuild build badge Build Butrelinux ISO Image smoke tests
works on my machine badge Download butrelinux

butrelinux

a bluefin-lts variant for those who want EL10+KDE

local package layering is disabled by default. you can change this with the command below, though the intended workflow is distrobox + flatpaks.

sudo givemethekeys unlock
givemethekeys usage
Usage: givemethekeys <command> [options]

Commands:
  unlock    Allow rpm-ostree package layering
  lock      Restore default layering lock
  status    Show current layering lock status
  help      Show this help

Options:
  -y, --yes    Skip confirmation prompt (unlock only)

installation

ISO downloads available here:
Download butrelinux
the ISO is the main installation path, rebase instructions are provided for convenience for existing bluefin lts users.

rebase instructions

rebase instructions if you use the rebase instructions you must rebase from a centos stream derived image such as bluefin-lts, not any fedora version. this image is based on centos stream 10, not fedora, and cross-rebasing will break things. > [!WARNING] > [This is an experimental feature](https://www.fedoraproject.org/wiki/Changes/OstreeNativeContainerStable), try at your own discretion. to rebase an existing EL10 based installation to the latest build: ####
# optionally clean up default flatpaks
flatpak uninstall --all
# switch to the signed image and reboot:
sudo bootc switch --enforce-container-sigpolicy ghcr.io/butrejp/butrelinux-< VARIANT >:latest --apply
after the system reboots:
# since skel can't touch existing users, optionally copy the default configs to your user profile
# or just make your own config.  I'm not your mom.
mkdir -p ~/.config && cp -r /etc/skel/.config/* ~/.config/

verification

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/butrejp/butrelinux-< VARIANT >
if you ever hit ASN.1 invalid signature failure during an upgrade it's because I rotated out the keys. sorry. it was probably dependabot's fault. you can fetch the new keys with the following command
sudo curl -Lo /etc/pki/containers/butrelinux.pub https://raw.githubusercontent.com/butrejp/butrelinux/refs/heads/main/cosign.pub
this shouldn't ever be an issue, but it's worth documenting.