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 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 25, 2023: :book: Fix grammatical structure (#961) (eea5d87)