Version: Next 🚧

Choosing Kubernetes Distribution

This example shows how to build Kairos with Kubernetes enabled.

info

At the moment, the official provider-kairos supports these two distributions (k3s and k0s). If you need a different Kubernetes distribution, there are community providers that can be used to extend Kairos with other options.

k3s

FROM ubuntu:24.04
FROM quay.io/kairos/kairos-init:v0.6.2 AS kairos-init

ARG VERSION=v1.0.0

RUN --mount=type=bind,from=kairos-init,src=/kairos-init,dst=/kairos-init \
  /kairos-init -l debug -s install --version "${VERSION}" --provider k3s --provider-k3s-version latest && \
  /kairos-init -l debug -s init --version "${VERSION}"

k0s

FROM ubuntu:24.04
FROM quay.io/kairos/kairos-init:v0.6.2 AS kairos-init

ARG VERSION=v1.0.0

RUN --mount=type=bind,from=kairos-init,src=/kairos-init,dst=/kairos-init \
  /kairos-init -l debug -s install --version "${VERSION}" --provider k0s --provider-k0s-version latest && \
  /kairos-init -l debug -s init --version "${VERSION}"

Build either version with:

docker build -t my-kairos-k8s:v1.0.0 .

k3s​

k0s​

k3s

k0s