Katl builds KatlOS: an installable, upgradeable, systemd-native operating system for Kubernetes nodes.

Download KatlOS · Installation guide · Kubernetes bundles · Source

KatlOS provides a small, immutable, versioned node OS built around modern systemd primitives. Katl owns installation, OS updates, rollback, and generation-scoped node configuration. Kubernetes remains an independently versioned system extension, so operators can select an exact Kubernetes patch without rebuilding or redistributing the base OS.

• Self-contained installation media. The installer ISO includes the matching KatlOS root image.
• Immutable and recoverable. Versioned roots, UKIs, systemd-sysext, and explicit generations make upgrades and rollback observable.
• Kubeadm-ready, not a Kubernetes distribution. Katl prepares and manages the node lifecycle; kubeadm and your GitOps stack manage the cluster.
• Native systemd configuration. Katl compiles user configuration into systemd sysext/confext payloads instead of hiding the host behind a lossy abstraction.

1. Download the katl-installer.iso asset from the current KatlOS development release.

2. Follow the installation guide to install KatlOS and provide node bootstrap configuration.

3. Select a published Kubernetes bundle, for example:

   ghcr.io/katl-dev/kubernetes:v1.36.0-katl.3
   

   Katl accepts the readable tag, but pinning its OCI manifest digest is strongly recommended for reproducible provisioning:

   ghcr.io/katl-dev/kubernetes:v1.36.0-katl.3@sha256:<manifest-digest>
   

Katl verifies the OCI manifest, bundle metadata, payload digest, size, and KatlOS runtime compatibility before staging the Kubernetes extension.

• Read the Katl repository for source and architecture documentation.
• Use the developer guide to build, test, and contribute.
• Report defects or propose work through GitHub Issues.
• Katl is available under the MIT License.