You are viewing documentation for the Kairos release v3.2.4. For the latest release, click here.

Takeover

Kairos supports takeover installations. Here are a few summarized steps:

From the dedicated control panel (OVH, Hetzner, etc.), boot in rescue mode
Install docker and run for example:

export DEVICE=/dev/sda
export IMAGE=quay.io/kairos/ubuntu:24.04-core-amd64-generic-v3.2.4
cat <<'EOF' > config.yaml
#cloud-config
users:
- name: "kairos"
  passwd: "kairos"
  ssh_authorized_keys:
  - github:mudler
EOF
export CONFIG_FILE=config.yaml
docker run --privileged -v $PWD:/data -v /dev:/dev -ti $IMAGE kairos-agent manual-install --device $DEVICE --source dir:/ /data/$CONFIG_FILE

Note

--source flag refers to the source of installation. If you want to install from the pulled docker image you can set the --source flag to dir:/ to use the root dir of the image as install source. Otherwise you can point it to an oci image with the oci: prefix.

Switch back to booting from HD and reboot.

Last modified August 8, 2024: remove requirement for meta-distro class (b290f31)