Skip to content

About

A cat-themed, lightweight Linux distribution based on Fedora XFCE Spin 🐾

Topics

Resources

Contributing

Stars

1 star

Watchers

1 watching

Forks

Repository files navigation

Calico Linux

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

Building via GitHub Actions

  1. Go to Actions → Build Calico Linux ISO → Run workflow.
  2. Provide a version (e.g. 1.0.0) and optional release_notes.
  3. 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.

Building locally

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

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

Verifying a build

sha256sum Calico-Linux-<version>.iso

Compare against the .iso.sha256 file attached to the release.

Known constraints

  • Built against Fedora f42 (stable). Change the branch in the workflow and calico.ks includes 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.ks and fedora-xfce-common.ks; calico.ks only adds to (or trims from) that set.
  • kitty is installed but xfce4-terminal stays the default terminal; switch with xfce4-settings-manager → Preferred Applications if you want kitty instead.
  • 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 from isolinux/initrd0.img, and anaconda builds a fresh one when installing to disk).
  • kitty 0.43.1 (the version in Fedora 42) prints a spurious [glfw error 65544]: Notify: Failed to get server capabilities warning on XFCE/most VMs. It is a known upstream timing bug (kovidgoyal/kitty#10215) and kitty still starts and works.

Layout

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

💖 Support the Project

If you enjoy Calico Linux and want to help keep the project alive, you can support me here:

DonationAlerts

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! ❤️

👤 Author

  • FelineFantasy
  • License: MIT

Quick Start

Use GitHub Actions workflow dispatch with version and optional release notes to build the ISO.

About

A cat-themed, lightweight Linux distribution based on Fedora XFCE Spin 🐾

Topics

Resources

Contributing

Stars

1 star

Watchers

1 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages