✨ Xero Arch Installer v1.0

A beautiful, streamlined Arch Linux installer designed by XeroLinux with a modern TUI.

Features

• 🎨 Beautiful TUI - Modern interface using gum for clean menus
• 💾 Flexible Disk Setup - Support for BTRFS (with subvolumes), EXT4, XFS
• 🔒 LUKS Encryption - Optional full disk encryption
• 🎮 Graphics Drivers - Easy selection for NVIDIA, AMD, Intel, or VMs
• 🔄 Smart Swap - ZRAM with compression or traditional swap file
• 🚀 Automated KDE Setup - Runs XeroLinux KDE installer.

Quick Start

Boot into the Arch Linux live ISO and run the following command :

bash <(curl -fsSL https://xerolinux.xyz/script/xero-install/install.sh)

Or step by step:

# Connect to internet (for WiFi)
iwctl

# Run installer
curl -fsSL https://xerolinux.xyz/script/xero-install/install.sh | bash

What Gets Installed

Base System

• Linux kernel + headers
• GRUB bootloader
• Essential system utilities
• NetworkManager

After Base Install

The installer automatically runs the XeroLinux KDE script which installs:

• KDE Plasma Desktop
• XeroLinux curated applications
• System tools and utilities
• Optional: Xero-Layan theme

Configuration Options

1. Installer Language

Select the interface language for the installer.

2. Locales

• System Locale: Language and encoding (e.g., en_US.UTF-8)
• Keyboard Layout: Console keyboard layout (e.g., us, de, fr)

3. Disk Configuration

• Target Disk: Select installation disk (⚠️ will be erased!)
• Filesystem: BTRFS (recommended), EXT4, or XFS
• Encryption: Optional LUKS2 full disk encryption

4. Swap

• ZRAM: Compressed RAM swap (recommended)
• File: Traditional swap file
• None: No swap

5. Hostname

System hostname (e.g., xero-desktop)

6. Graphics Driver

• mesa-all: All open-source drivers (safe default)
• nvidia-prop: NVIDIA proprietary (best gaming performance)
• nvidia-open: NVIDIA open kernel module (Turing+ GPUs)
• nvidia-nouveau: NVIDIA open-source nouveau
• amd: AMD/ATI open-source
• intel: Intel open-source
• vm: Virtual machine drivers

7. Authentication

• Username: Your user account
• User Password: Password for your account
• Root Password: System root password

8. Timezone

Select your region and city for timezone configuration.

BTRFS Subvolume Layout

When using BTRFS, the installer creates:

Encryption

When enabled, the installer:

1. Creates a LUKS2 encrypted container
2. Configures mkinitcpio with encrypt hook
3. Sets up GRUB with proper kernel parameters
4. Prompts for password at boot

File Structure

xero-install/
├── install.sh          # Curl launcher script
├── xero-install.sh     # Main installer
└── README.md           # This file

Requirements

• Arch Linux live ISO (latest recommended)
• Internet connection
• UEFI or BIOS system
• At least 20GB disk space

Troubleshooting

No internet connection

# For WiFi
iwctl
[iwd]# device list
[iwd]# station wlan0 scan
[iwd]# station wlan0 get-networks
[iwd]# station wlan0 connect "NetworkName"

# For Ethernet
dhcpcd

Installer won’t start

# Install gum manually
pacman -Sy gum

# Run installer directly
bash xero-install.sh

NVIDIA issues after install

# Regenerate initramfs
sudo mkinitcpio -P

# Rebuild GRUB config
sudo grub-mkconfig -o /boot/grub/grub.cfg

Customization

Adding Packages

Modify the install_base_system() function to add packages to the base install.

Version History

• v1.0 - Initial release
  • Gum-based TUI
  • BTRFS with subvolumes
  • LUKS encryption support
  • Graphics driver selection
  • ZRAM swap support

Credits

• archinstall - Inspiration and logic reference
• gum - Beautiful TUI components
• XeroLinux - Distribution and KDE configuration

License

GPL-3.0 License - See LICENSE for details.

Made with ❤️ by the XeroLinux Team