v0.1 — early development 
  ███████╗███╗   ██╗██████╗ ███████╗██████╗
  ██╔════╝████╗  ██║██╔══██╗██╔════╝██╔══██╗
  █████╗  ██╔██╗ ██║██║  ██║█████╗  ██████╔╝
  ██╔══╝  ██║╚██╗██║██║  ██║██╔══╝  ██╔══██╗
  ███████╗██║ ╚████║██████╔╝███████╗██║  ██║
  ╚══════╝╚═╝  ╚═══╝╚═════╝ ╚══════╝╚═╝  ╚═╝
                                   ██████╗ ███████╗
                                  ██╔═══██╗██╔════╝
                                  ██║   ██║███████╗
                                  ██║   ██║╚════██║
                                  ╚██████╔╝███████║
                                   ╚═════╝ ╚══════╝

enderOS Linux

An Arch-based Linux distribution. Currently in early development — v0.1 boots to a shell, no desktop environment yet.

↓ Download v0.1 → Read the Wiki

Base

Arch

Rolling release, built with archiso. Full pacman and AUR support.

Desktop environment

none yet

v0.1 drops you into a TTY. A DE is planned. For now, install your own.

Installer

manual

No GUI installer yet. Calamares integration is in progress but currently non-functional.

// What's in v0.1
[✓]
Bootable ISO
Built with archiso. Boots in both UEFI and BIOS mode. Tested in VirtualBox.
[✓]
Custom identity
Live environment correctly identifies as enderOS. Hostname, branding in place.
[✓]
fish shell
Default interactive shell. Autosuggestions and syntax highlighting with no config needed.
[✓]
yay pre-installed
Full AUR access from first boot. No extra setup required.
[ ]
GUI installer — planned
Calamares is being integrated. Currently broken (missing kcrash / libKF6Crash.so.6).
[ ]
Desktop environment — planned
No DE in v0.1. KDE Plasma is the current candidate for a future release.
// News
2025-03-31
enderOS 0.1 — first public ISO release — Boots to TTY. fish + yay included. Manual install only.
ongoing
Calamares integration wip — Blocked on missing kcrash package. Fix being worked on.
2025-01-05
Project started news — archiso profile created. Build system bootstrapped.

Installation

v0.1 has no GUI installer. Installation is done manually from the live shell.

On this page

Requirements

See also

HEADS UP — v0.1 boots to a TTY. There is no desktop environment and no graphical installer. If you want a point-and-click setup experience, this release isn't there yet.

Download

One ISO. Minimal live environment: a shell, pacman, fish, yay. That's it.

v0.1 EARLY
enderOS 0.1 — Minimal (TTY only, no DE)
2025-03-31 no GUI installer fish + yay included
↓ Download ISO

Write to USB

Use dd on Linux/macOS. Verify the device path before running — this will erase the target device completely.

WARNING — Double-check your device path with lsblk. Writing to the wrong device means data loss.
# identify your USB device lsblk # write the ISO (replace /dev/sdX with your device) sudo dd bs=4M if=enderOS-0.1-x86_64.iso of=/dev/sdX status=progress oflag=sync

Boot the live environment

Plug in the USB, reboot, enter your firmware's boot menu (F12, F2, Del, or Esc depending on your board), and select the USB drive. You'll land at a TTY as root.

Install manually

Since there's no installer yet, follow the standard Arch Linux installation procedure. The Arch installation guide applies directly — the live environment has everything needed: pacstrap, arch-chroot, genfstab, fdisk.

  1. Partition your disk with fdisk or cfdisk
  2. Format and mount partitions under /mnt
  3. Install the base system: pacstrap -K /mnt base linux linux-firmware
  4. Generate fstab: genfstab -U /mnt >> /mnt/etc/fstab
  5. Chroot in: arch-chroot /mnt
  6. Set timezone, locale, hostname, root password
  7. Install a bootloader (grub or systemd-boot)
  8. Exit chroot, unmount, reboot

After first boot into the installed system, install whatever you need — a DE, a display manager, drivers. The wiki has post-install suggestions.

Wiki

Documentation for enderOS. Work in progress — like the distro itself.

Getting started

Package management

System

Build system