Skip to main content
Version: Next 🚧

Without Kubernetes

This example shows how to build a Kairos image without Kubernetes.

The key point is simple: run kairos-init without --provider and --provider-<name>-version flags.

Dockerfile example (core image)​

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}" && \
  /kairos-init -l debug -s init --version "${VERSION}"

Because no provider flags are passed, the resulting image stays core (no Kubernetes distribution installed).

Build​

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

If later you want to add Kubernetes, use provider flags (for example --provider k3s --provider-k3s-version <release>) as documented in Kairos Factory.