Compatibility

Hardware

Any equipment can be used, arm64 or amd64. The reference deployment runs on Raspberry Pi 4 boards with USB disks for Longhorn; its hardware is described in the homelab instance.

Operating System

Any Debian based system should work: tested with Debian 12 (bookworm) and Debian 13 (trixie), including Raspberry Pi OS (64-bit) upgraded in place to Debian 13 on the Debian generic arm64 kernel (the opt-in kernel-upgrade Ansible tag). In-place major version upgrades are supported via the dist-upgrade Ansible tag (see Maintenance).

For Raspberry, see :

• https://www.raspberrypi.com/software
• https://www.raspberrypi.com/software/operating-systems

To perform multiple OS installation in parallel on multiple devices take a look at setup-pi.sh script.

Access

Each target server should have a static IP address to maintain consistency in the inventory file hosts.yml, update this file with the appropriate values.

SSH access to all machines is needed to install infrastructure, username/password or ssh key could be used.

Kubernetes admin access is needed to install services, it use kubeconfig and the run.sh wrapper script will ask to confirm the context.