Skip to content


kairos-white-column 5bc2fe34

The immutable Linux meta-distribution for edge Kubernetes

With Kairos you can build immutable, bootable Kubernetes and OS images for your edge devices as easily as writing a Dockerfile. Optional P2P mesh with distributed ledger automates node bootstrapping and coordination. Updating nodes is as easy as CI/CD: push a new image to your container registry and let secure, risk-free A/B atomic upgrades do the rest.

  • :bowtie: Community Driven
  • :octocat: Open Source
  • 🔒 Linux immutable, meta-distribution
  • 🔑 Secure
  • 🐳 Container based
  • 🐧 Distribution agnostic

Nodes are configured via cloud-init and supports zero-touch configuration and complete lifecycle management with CAPI.

The Kairos 'factory' enables you to build custom bootable OS images for your edge devices, from your choice of OS (including openSUSE, Alpine and Ubuntu) and your choice of edge Kubernetes distribution - Kairos is totally agnostic.

Getting Started 📚

Did you find a bug? Do you want to contribute and propose new requests?

Please feel free to file an issue here!

Contributing 🙌

That's awesome! 🥳 We welcome any contribution!

If you wish to start contributing, and want to understand more our process check out also:

Pinned Loading

  1. kairos kairos Public

    The immutable Linux meta-distribution for edge Kubernetes.

    Go 1.9k 161

  2. hadron hadron Public

    Hadron is a minimal, from-scratch Linux distro using vanilla components, engineered for trusted and flexible boot environments.

    Dockerfile 75 17

  3. kairos-agent kairos-agent Public archive

    🔧 Lifecycle agent for kairos

    Go 18 28

  4. provider-kairos provider-kairos Public archive

    🌱 k3s and k0s, plus optional libp2p support for Kairos. Build decentralized cluster with libp2p that stretch across 1000km!

    Go 52 24

  5. AuroraBoot AuroraBoot Public archive

    🐣 Kairos bootstrapper

    Go 43 32

  6. kairos-init kairos-init Public archive

    🌱 Kairos init will transform a normal docker image into a Kairos flavored one

    Go 16 19

Repositories

Showing 10 of 61 repositories
  • hadron Public

    Hadron is a minimal, from-scratch Linux distro using vanilla components, engineered for trusted and flexible boot environments.

    kairos-io/hadron's past year of commit activity
    Dockerfile 75 Apache-2.0 17 1 2 Updated Nov 21, 2026
  • hadron-layers Public
    kairos-io/hadron-layers's past year of commit activity
    Dockerfile 1 Apache-2.0 7 1 1 Updated Nov 21, 2026
  • kairos Public

    The immutable Linux meta-distribution for edge Kubernetes.

    kairos-io/kairos's past year of commit activity
    Go 1,870 Apache-2.0 161 451 (1 issue needs help) 114 Updated Nov 21, 2026
  • security Public

    Security dashboard for the Kairos team

    kairos-io/security's past year of commit activity
    Go 0 Apache-2.0 2 1 7 Updated Nov 21, 2026
  • provider-kubernetes Public

    Kairos kubeadm Provider

    kairos-io/provider-kubernetes's past year of commit activity
    Go 1 Apache-2.0 5 1 17 Updated Nov 21, 2026
  • packages.kairos.io Public

    📦 package browser website

    kairos-io/packages.kairos.io's past year of commit activity
    Go Template 1 Apache-2.0 2 1 2 Updated Nov 21, 2026
  • go-nodepair Public

    Golang library to handle transparent remote node pairing

    kairos-io/go-nodepair's past year of commit activity
    Go 5 Apache-2.0 4 1 16 Updated Nov 20, 2026
  • kairos-io/kairos-operator's past year of commit activity
    Go 8 Apache-2.0 19 1 38 Updated Nov 20, 2026
  • cluster-api-provider-kairos Public

    Kairos CAPI Provider

    kairos-io/cluster-api-provider-kairos's past year of commit activity
    Go 16 8 1 1 Updated Nov 20, 2026
  • cluster-api-provider-kairos-fleet Public

    CAPI Infrastructure Provider backed by Kairos Fleet (AKA AuroraBoot)

    kairos-io/cluster-api-provider-kairos-fleet's past year of commit activity
    Go 3 4 0 1 Updated Nov 20, 2026