RaspberryPi

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

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. Note it’s compressed with “XZ”, so we need to decompress it first:

sudo dd if=kairos-@flavor-@flavorRelease-standard-arm64-rpi4-master-k3sv1.32.1+k3s1.raw of=<device> oflag=sync status=progress bs=10MB

Once the image is flashed, there is no need to carry any other installation steps. We can boot the image, or apply our config.

Boot

Use the SD Card to boot. The default username/password is kairos/kairos. To configure your access or disable password change the /usr/local/cloud-config/01_defaults.yaml accordingly.

Configure your node

To configure the device beforehand, be sure to have the SD plugged in your host. We need to copy a configuration file into cloud-config in the COS_PERSISTENT partition:

$ PERSISTENT=$(blkid -L COS_PERSISTENT)
$ mkdir /tmp/persistent
$ sudo mount $PERSISTENT /tmp/persistent
$ sudo mkdir /tmp/persistent/cloud-config
$ sudo cp cloud-config.yaml /tmp/persistent/cloud-config
$ sudo umount /tmp/persistent

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