Examples

This section contains various examples, how-to and tutorial to use Kairos

Welcome to the examples section of the Kairos documentation! Here, you will find a variety of examples that demonstrate how to use Kairos to create and manage Kubernetes clusters on bare metal.

Getting Started

  • Quick Start Guide: This guide will walk you through the process of installing Kairos and creating your first Kubernetes cluster on bare metal.

Troubleshooting


Multi Node k3s cluster

This section describe examples on how to deploy Kairos with k3s as a multi-node cluster

Single Node k3s cluster

This section describe examples on how to deploy Kairos with k3s as a single-node cluster

High Availability K3s deployments

This section contains instructions how to deploy Kairos with a High Available control-plane for K3s

Bundles

This section describe examples on how to use a Kairos bundle to deploy MetalLB on top of K3s

MetalLB

This section describe examples on how to deploy Kairos with k3s and MetalLB

Using Kairos Core Images as an Installer

Core images serve as the foundation for creating downstream images or as an installer for deploying other images during the installation process. In this guide, we’ll take a closer look at using Kairos core images as an installer to deploy other container images.

Configuring Automatic High Availability in Kairos

Kairos makes it easy to configure automatic High Availability (HA) in your cluster by using cloud-config. With just a few simple steps, you can have a fully-functioning HA setup in your cluster.

Deploying a High-Availability K3s Cluster with KubeVIP

This guide walks through the process of deploying a highly-available, P2P self-coordinated k3s cluster with KubeVIP, which provides a high available Elastic IP for the control plane.

P2P multi-node cluster

Install Kairos with p2p support, on a multi-node cluster

P2P single-node cluster

This documentation page provides instructions on how to install Kairos with P2P support on a single-node cluster