A Fedora XFCE live spin, rebranded as Calico Linux. 🐾
Built from upstream fedora-kickstarts with a small calico.ks overlay that rebrands os-release, greets you with a cat on login, ships fastfetch with a branded config, and adds a small set of quality-of-life CLI tools (kitty, bat, eza, fzf, zoxide, ripgrep, fd-find, jq, tree, btop, ncdu, duf, inxi, micro, tmux, git, unzip, p7zip, zstd).
- Go to Actions → Build Calico Linux ISO → Run workflow.
- Provide a
version(e.g.1.0.0) and optionalrelease_notes. - Wait for the job to finish. The ISO is uploaded as an artifact and attached to a new GitHub release tagged
v<version>.
Build time is typically 15–30 minutes on a GitHub-hosted runner.
The build must run inside a Fedora container, because livecd-creator requires an RPM-based host.
The simplest option is the helper script, which wraps the same container run as CI:
./scripts/build-local.sh 1.0.0The argument is used as the ISO label (Calico-Linux-<version>); it defaults to
dev. Set FEDORA_RELEASE to target another Fedora branch (default: 42).
To run the container manually instead:
docker run --privileged --rm -it \
-v "$PWD:/work" -w /work \
fedora:42 bash -c '
set -euo pipefail
dnf install -y livecd-tools spin-kickstarts git
git clone --depth 1 --branch f42 https://pagure.io/fedora-kickstarts.git /tmp/ks
cp /work/calico.ks /tmp/ks/calico.ks
cp -r /work/configs /tmp/ks/configs
cd /tmp/ks
livecd-creator \
--config=calico.ks \
--fslabel="Calico-Linux-dev" \
--cache=/var/cache/live \
-p /tmp/ks
cp /tmp/ks/*.iso /work/
'Requires --privileged and around 20 GiB of free disk space.
sha256sum Calico-Linux-<version>.isoCompare against the .iso.sha256 file attached to the release.
- Built against Fedora f42 (stable). Change the branch in the workflow and
calico.ksincludes to target a different release. - Root partition is 8 GiB, sized for XFCE + fastfetch.
- Kernel, drivers and the base package set come from upstream
fedora-live-base.ksandfedora-xfce-common.ks;calico.ksonly adds to (or trims from) that set. kittyis installed butxfce4-terminalstays the default terminal; switch withxfce4-settings-manager→ Preferred Applications if you wantkittyinstead.- The ISO must stay below GitHub's 2 GiB release-asset limit. The live root filesystem therefore ships without its own copy of the initramfs in
/boot(the ISO boots fromisolinux/initrd0.img, and anaconda builds a fresh one when installing to disk). kitty0.43.1 (the version in Fedora 42) prints a spurious[glfw error 65544]: Notify: Failed to get server capabilitieswarning on XFCE/most VMs. It is a known upstream timing bug (kovidgoyal/kitty#10215) andkittystill starts and works.
calico.ks # kickstart overlay
configs/fastfetch/ # fastfetch config and ASCII logo shipped in the image
scripts/build-local.sh # containerised local build helper
.github/workflows/build.yml # CI that produces the ISO
README.md # this file
If you enjoy Calico Linux and want to help keep the project alive, you can support me here:
Your support helps me:
- 🐾 Keep the distro updated with new Fedora releases
- 🎨 Improve branding, wallpapers and default configs
- 🛠️ Fix build issues and add new packages
- ☕ Stay awake while debugging kickstarts at 4 AM
Every little bit is appreciated! ❤️
- FelineFantasy
- License: MIT
Use GitHub Actions workflow dispatch with version and optional release notes to build the ISO.