Guided installation


We are so glad you want to install Xenia Linux! The installation can be boiled down to the following steps:

  1. Download and boot live media

  2. Download the installer

  3. Run it!

Booting live media

The installer relies on certain libraries that are not present in the Gentoo LiveCD, so currently we recommend the use of a Fedora ISO to use as an installation environment. It is likely other distros will work as well!

Once you are booted into live media, you should setup networking. On Fedora, you can do this in GNOME settings.

Downloading the installer

Open a terminal and download the installer:

git clone

Enter the installer’s directory:

cd installer

Run the installer


The installer won’t run without root privileges! Make sure you use sudo here or become root through other means.

sudo ./
[INFO] Entering interactive mode. Default values are shown wrapped in square brackets like [this]. Press enter to accept the default.

Enter value for 'drive'. Valid options are ['/dev/nvme0n1', '/dev/nvme1n1', '/dev/sda'].

You will be put into interactive mode of the installer. When asking for values, the installer will give you a list of valid options. The default option will be shown in the square brackets.


For the drive, pick your drive out of the valid options. If you don’t know your drive, you can open another terminal and type lsblk to see how all the drives on the system and how large they are.

Root image URL

Sticking with the default here is recommended, unless you need to use your own root image or the unstable branch. Press enter to use the default. See here for more options.


Here is where you choose which filesystem layout you would like. The default of btrfs is recommended here, which gives features such as snapshots. Older versions of Xenia Linux used the LVM layout, and the traditional layout is just ext4 formatted partitions. You can find more information about the different layouts here.


Enter a username here that you would like to use as your user. A password will be prompted for later.


Here, choose either recommended or minimal for packages to install. Recommended will install applications such as a web browser, image viewer, email client and the like with flatpak when you boot into the system. Minimal does not install any extra packages, and the user will need to install these packages themselves through a terminal or GNOME Software.


With the installer configured, you’ll see the following warning:

[WARN] Drive partitioning is about to start. After this process, drive /dev/sda will be erased. Press enter to continue.

When you are ready, press enter to begin the installation!

When the installer is complete, you can reboot into your new installation. You can login with the user you created earlier.

We hope you love Xenia Linux!