RaspberryPi

Info

Kairos supports Raspberry Pi model 3 and 4 with 64bit architecture.

Warning

Model 5 is currently not supported because of how we use U-boot to boot the device. There's currently some work from the people from SUSE, see https://github.com/openSUSE/u-boot/pull/29 for more information.

If you are not familiar with the process, it is suggested to follow the quickstart first to see how Kairos works.

Prerequisites

• An SD card which size is at least 16 GB
• Etcher or dd
• A Linux host where to flash the device

Install using AuroraBoot

Create build directory and add cloud-config.yaml, then run:

docker run --rm --privileged -v /var/run/docker.sock:/var/run/docker.sock \
                --platform linux/arm64 -v $PWD/build/:/output \
                quay.io/kairos/auroraboot:latest \
                --debug --set "disable_http_server=true" --set "disable_netboot=true" \
                --set "state_dir=/output" --set "disk.raw=true" \
                --cloud-config /output/cloud-config.yaml \
                --set "container_image=quay.io/kairos/ubuntu:24.04-standard-arm64-rpi4-v3.5.7-k3sv1.34.1-k3s1"

Once complete, use Etcher or dd to flash the image to an SD card:

This example is compatible with openSUSE Leap-15.6, openSUSE Tumbleweed, Ubuntu 20.04, Ubuntu 22.04, Alpine 3.19. Your current flavor is Ubuntu 24.04.

sudo dd if=build/kairos-ubuntu-24.04-standard-arm64-rpi4-v3.5.7-k3sv1.34.1+k3s1.raw of=<device> oflag=sync status=progress bs=10M

Install using images

Download

Extract the img file from a container image as described in this page

Flash the image

Plug the SD card to your system. To flash the image, you can either use Etcher or dd:

This example is compatible with openSUSE Leap-15.6, openSUSE Tumbleweed, Ubuntu 20.04, Ubuntu 22.04, Alpine 3.19. Your current flavor is Ubuntu 24.04.

sudo dd if=kairos-ubuntu-24.04-standard-arm64-rpi4-v3.5.7-k3sv1.34.1+k3s1.raw of=<device> oflag=sync status=progress bs=10MB

Once the image is flashed, there is no need to carry out any other installation steps, it can be booted right away. However you may want to add a cloud-config at this point - see below.

Boot

Use the SD Card to boot the device. During the first boot, the system will enter recovery mode and create the COS_STATE and COS_PERSISTENT volumes. After creating the volumes, the system will automatically reboot. This process may take a few minutes depending on the size and speed of the storage. The default username/password for the system is kairos/kairos. To configure your access or disable password change the /oem/90_custom.yaml accordingly.

Configure your node

To configure the device beforehand, be sure to have the SD plugged in your host. We need to overwrite the default configuration file with the desired cloud-config in the COS_OEM partition:

$ OEM=$(blkid -L COS_OEM)
$ mkdir /tmp/oem
$ sudo mount $OEM /tmp/oem
$ sudo cp cloud-config.yaml /tmp/oem/90_custom.yaml
$ sudo umount /tmp/oem

You can push additional cloud config files. For a full reference check out the docs and also configuration after-installation