Manual installation

Install Kairos manually

To install manually, follow the quickstart. When the QR code is prompted at the screen, you will be able to log in via SSH to the box with the password kairos as kairos user.


To start the installation, run the following command from the console:

sudo kairos-agent manual-install --device "auto" $CONFIG

Where the configuration can be a cloud-init file or a URL to it:


  network_token: ....
# extra configuration

The token p2p.network_token is a base64 encoded string which contains an edgevpn token. For more information, check out the architecture section.


  • The command is disruptive and will erase any content on the drive.
  • The parameter “auto” selects the biggest drive available in the machine.

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