Kairos internal architecture
This section contains refrences to how Kairos works internally.
kairos node at first boot will start the
kairos-agent service, you can always check what’s happening by running
journalctl -fu kairos-agent.
This service will setup
edgevpn dynamically on first-boot, once it configures the machine it does not run on boot anymore, unless
/usr/local/.kairos/deployed is removed..
Those are the steps executed in sequence by the
- Will create a
edgevpn@kairosservice and enabled on start. The configuration for the connection is stored in
/etc/systemd/system.conf.d/edgevpn-kairos.envand depends on the cloud-init configuration file provided during installation time
- Automatic role negotiation starts, nodes will co-ordinate for an IP and a role
- Once roles are defined a node will either set the
k3s-agentservice. Configuration for each service is stored in
The following paths are relevant for Kairos:
|/usr/local/.kairos/deployed||Sentinel file written after bootstrapping is complete. Remove to retrigger automatic bootstrap|
|/usr/local/.kairos/lease||IP Lease of the node in the network. Delete to change IP address of the node|
Was this page helpful?
Awesome! Glad to hear it! Please tell us how we can improve.
Oh snap! Sorry to hear that. Please tell us how we can improve.
Last modified April 25, 2023: Move docs into root (f4e3511)