Install

Check the system requirements first. There are three ways to get Kleinia:

	Best for
Install from the ISO	A spare computer
Install in a virtual machine	Trying the preview safely
Switch from Fedora Atomic	An existing Fedora Silverblue, Kinoite or other bootc system

Install from the ISO

Danger

Installing erases the disk you choose. Back up anything you want to keep first.

1. Download the ISO from kleinia.io/download.

2. Verify the download.

3. Write the ISO to a USB drive of at least 8 GB. Fedora Media Writer or GNOME Disks (“Restore Disk Image”) can do it, or from a terminal:

   sudo dd if=kleinia-0.1-aloe-x86_64.iso of=/dev/sdX bs=4M status=progress oflag=sync

   Replace /dev/sdX with your USB device. dd overwrites the target without asking.

4. Boot from the USB drive. Most computers open a boot menu with F12, F10 or Esc at power-on.

5. The live desktop starts. Open Install Kleinia and follow the installer: language, keyboard, time zone, the disk to install on, and your user account.

6. When the installer finishes, restart and remove the USB drive.

Draft

In the preview the installer uses the whole disk. Installing alongside another operating system is not supported yet.

Verify the download

Always check the checksum and signature before installing:

curl -LO https://dl.kleinia.io/0.1/SHA256SUMS -LO https://dl.kleinia.io/0.1/SHA256SUMS.asc
curl -L https://dl.kleinia.io/kleinia-release.asc | gpg --import
gpg --verify SHA256SUMS.asc SHA256SUMS
sha256sum -c SHA256SUMS --ignore-missing

gpg should report a good signature, and sha256sum should print OK for the ISO. Compare the key fingerprint with the one on the download page.

Install in a virtual machine

1. Download and verify the ISO as above.
2. Create a virtual machine with UEFI firmware, 4 CPUs, 8 GB of memory and a 64 GB disk. In GNOME Boxes, choose Create a Virtual Machine → Install from File and pick the ISO; in virt-manager, tick Customize configuration before install and set the firmware to UEFI.
3. Boot it and install as you would on a computer.

Switch from Fedora Atomic

If you already run Fedora Silverblue, Kinoite or another bootc-based system, you can switch without reinstalling. Your files, Flatpak apps and user accounts are kept.

sudo bootc switch ghcr.io/kleinia-os/kleinia:aloe
systemctl reboot

Your previous deployment stays in the boot menu. To go back, see Updates and rollback.

Next

First steps after installing.