Welcome to Xenia Linux’s documentation!

Xenia Linux is an immutable OS based on Gentoo Linux. Xenia Linux boots from a SquashFS (the root), much like how a LiveCD works.

Xenia Linux includes the GNOME desktop environment, a selection of filesystems, and versatility with Flatpak, Distrobox and Portage available to install packages with. Xenia Linux includes your entire system on one file, which can be swapped out for a newer one when updates come.

We named Xenia Linux after the popular Linux mascot who lost to Tux.

The documentation contains guides on installing the system (guided or manual installations), using the system, developing the system and system architecture.

Installation

• Install Xenia Linux
• Guided installation
  • Overview
  • Booting live media
  • Downloading the installer
  • Run the installer
  • Go!
• Manual installation
  • Overview
  • Prerequisites
  • Booting the live media
  • Setting up disks
  • Acquiring a root.img
  • Setting up the new system
  • Chroot into Xenia and install the bootloader

Usage

• Installing applications
  • Flatpak
  • Distrobox
  • foxmerge
• Updating the system
  • Prerequisites for 0.4 Velox
  • First-time setup
  • Updating
• Updating the system - Manual
  • Preparation
  • Download the new root
  • Finalising
  • Troubleshooting
• Add the Xenia portage overlay
  • Xenia specific steps
  • Installing eselect-repository
  • Add the overlay
  • Allowing live ebuilds
• Installing Virtual Machine Manager
  • Creating the container
  • Installing virt-manager
  • Starting required services & exporting
  • Setup the session

Development

• RootFS generation
  • Xenia setup
  • foxbuild installation
  • Creating a root image
  • Testing the image
  • Updating the build environment
  • Customising the image
• Manual rootFS generation
  • Requirements
  • First time setup
  • Create a snapshot
  • Pick a spec file
  • Spec file setup
  • Building
  • Converting to squashFS
  • Installation
• Customising the rootfs
  • Requirements
  • Packages
  • USE flags and other portage config
  • Adding services
  • Custom shell script
  • Filesystem overlay
  • Submitting changes to Xenia

Architecture

• Filesystem layouts
  • Traditional label-based layout (generic)
  • Traditional label-based layout (LVM)
  • Btrfs
  • Btrfs with encryption

Miscellaneous

• OpenRC flatpak workaround