P2P single-node cluster

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

Installing Kairos with P2P support on a single-node cluster requires a few specific steps. To begin, it’s important to note that in a single-node scenario, the role must be enforced to a specific role. In a non-HA (high availability) setup, that role can be either master or worker. In a single-node cluster, there will be only one master node that needs to be configured explicitly.

To set up a single-node cluster over P2P, consider the following example, which uses cloud-config to automatically configure the cluster:


hostname: kairoslab-{{ trunc 4 .MachineID }}
- name: kairos
  # Add your github user here!
  - github:mudler

 role: "master"
 # Disabling DHT makes co-ordination to discover nodes only in the local network
 disable_dht: true #Enabled by default

 # network_token is the shared secret used by the nodes to co-ordinate with p2p.
 # Setting a network token implies auto.enable = true.
 # To disable, just set auto.enable = false
 network_token: ""

The above cloud-config configures the hostname, creates a new user kairos, and sets the role to master. Additionally, it disables DHT (distributed hash table) to make the VPN functional only within the local network and use mDNS for discovery. If you wish to make the VPN work across different networks, you can set disable_dht to false or unset it.

The network_token field is a shared secret used by the nodes to coordinate with P2P. Setting a network token implies auto.enable. If you wish to disable it, simply set auto.enable to false. To generate a network token, see documentation.

Keep in mind that, this example is a minimal configuration, and you can add more options depending on your needs. The above configuration can be used as a starting point and can be customized further.

Last modified February 23, 2024: Reduce sizes and remove warnings (0e183ae)