Image support matrix
Kairos builds several artifacts for user convenience which are based on openSUSE, Alpine Linux, and Ubuntu.
The Kairos core team does its best to test all distributions but systemd based ones(e.g. openSUSE, ubuntu, ) are more throughly tested as are uniform and have homogeneus settings. Support for other flavors not using systemd (e.g. Alpine), get less priority in our plannings due to the team bandwidth. We encourage you to contribute, as Kairos is a community-driven, Open Source Project, and we welcome any contribution, bugreporting, bugfixing, check out our Contribution guidelines!
Besides, there is tighter integration with systemd for several features that are available only with it (e.g. live layering ).
The images are pushed over quay.io, and are available for installation and upgrading.
The installable mediums part of the releases are generated with the methods described in the automated installation reference from the images sources listed below, and the images can be used to point over for upgrades, as well.
Kairos release process generates images based on official container images from the major popular Linux Distributions, If you can’t find your preferred distribution first check if we are already planning support for it, or create a new issue.
Below you can find a list of the images and their respective location on the
- The Core images does not contain any Kubernetes engine. Those images can be used as base for manual customization.
- The Standard images contains
kairosprovider which enables Kubernetes deployments, optionally with p2p.
Base images are tagged against specific upstream versions (e.g Ubuntu 20 LTS pins to Ubuntu 20:04, opensuse to opensuse leap 15.4, …).
ubuntuflavor tracks the latest available Ubuntu release (at the time of writing 22.10). the LTS flavors instead are tracking the latest LTS available in dockerhub. i.e. ubuntu-22-lts uses 22.04 as base image
The pipelines don’t publish
img artifacts for arm architecture because the files are too big for Github Actions (they are above the artifact size limit).
They can be extracted from the published docker images with the following command:
export IMAGE=quay.io/kairos/core-alpine-arm-rpi:v1.1.7.img docker run -ti --rm -v $PWD:/image quay.io/luet/base util unpack "$IMAGE" /image
(replace with the proper image)
The artifacts are in the
Kairos follows Semantic Versioning and our releases versioning signal changes regarding the Kairos components, not changes to the OS, and underlaying packages versions. Flavors are pinned to specific upstream OS branches (e.g.
leap 15.4) and major version bumps would be reflected by either having new flavors in our build matrix or having specific releases to follow upstream with regard to minor version bumps (e.g.
leap 15.3 and
- We support only the latest release branch with patch releases.
- Patch releases ( e.g. 1.1.x ) follows a weekly release cadence, if needed, exceptions made for highly impacting bugs in Kairos itself or at the OS layer (e.g. High scored CVEs).
- Minor releases follows a monthly cadence and are expected to bring enhancements, with planned releases.
- Major releases signal a new a set of advanced features, or significant changes to the codebase. In-place upgrade from old to new major release branch is not always guaranteed, however we strive for compatibility among versions.
In order to give more control over the chosen base image (e.g.
Ubuntu, … ), and rely less on our CI infrastructure, we are actively working on streamling the creation of Kairos-based distributions directly from upstream base images. You can track the development progress over here.
If you need to further customize images, including base image changes, package updates, and CVE hotfixes, follow the customization docs.
Our changelog is published as part of the release process: it contains all the changeset, highlights and release notes that are pertinent to the release.
We strongly recommend to check every release changelog before running any upgrade, or while building your customized version of Kairos.
Release changelogs are available for Kairos core and for each component. Here you can find a list of the components that are part of a Kairos release and their respective release page with changelogs.
|Kairos provider (k3s support)||https://github.com/kairos-io/provider-kairos/releases|
Was this page helpful?
Awesome! Glad to hear it! Please tell us how we can improve.
Oh snap! Sorry to hear that. Please tell us how we can improve.