Prerequisits

Prerequisits

Prerequisits

A total of at least 7 machines are required:

  • one admin
  • at least three masters
  • at least three workers

Below you can see the supported operating systems with the associated minimal requirements for CPU, memory and disk storage:

OS Minimum Requirements
Red Hat Enterprise Linux 9.6 and newer 8 CPU cores, 16 GB memory, 50GB disk storage
Ubuntu 24.2 and newer 8 CPU cores, 16 GB memory, 50GB disk storage
  • For each working node, an additional unformatted hard disk with 50 GB each is required. For more information about the hard drives for rook-ceph, visit the rook-ceph prerequisites page

  • Each machine in the cluster needs to have the same username with the same password available. Otherwise the cluster creation and management process will fail!


Prerequisits for admin

The following requirements must be fulfilled on the admin machine.

  1. You need an internet connection to use the default KubeOps Registry.
registry.kubeops.net
A local registry can be used in the Airgap environment. KubeOps only supports secure registries. It is important to list your registry as an insecure registry in registry.conf (/etc/containers/registries.conf for podman, /etc/docker/deamon.json for docker), in case of insecure registry usage.

Prerequisits for each node

The following requirements must be fulfilled on each node.

  1. You have to assign lowercase unique hostnames for every machine you are using.
We recommended using self-explanatory hostnames.

To set the hostname on your machine use the following command:

sudo hostnamectl set-hostname <name of node>
Example

Use the commands below to set the hostnames on each machine as admin, master, node1 node2 (lowercase letters and numbers only).

sudo hostnamectl set-hostname admin

  1. Optional: In order to use encrypted traffic inside the cluster, follow these steps:

For RHEL machines, you will need to import the ELRepo Secure Boot key into your system. You can find a detailed explanation and comprehensive instructions in our how-to-guide Importing the Secure-Boot key

This is only necessary if your system has Secure Boot enabled. If this isn´t the case, or you dont want to use any encryption at all, you can skip this step.