Installation Guide

This guide walks you through installing Lunar Linux on your system.

Before You Begin

Ensure you have:

Met the system requirements
Backed up any important data
Created a bootable Lunar Linux USB drive

Installation Steps

1. Boot from Installation Media

Insert the Lunar Linux installation media
Restart your computer
Enter BIOS/UEFI settings (usually F2, F12, or Del key)
Set boot priority to USB/CD drive
Save and exit

2. Start the Installer

Once booted, you'll see the Lunar Linux welcome screen.

Start the installation process:

lunar-install

3. Partition Your Disk

The installer will guide you through disk partitioning.

Recommended partition scheme:

/dev/sda1  512M   EFI System Partition (if UEFI)
/dev/sda2  4G     Swap
/dev/sda3  Rest   Root filesystem (/)

4. Select Installation Profile

Choose your installation profile:

Minimal - Basic system only
Desktop - Includes X11 and desktop environment
Server - Optimized for server use

5. Configure Network

Configure your network connection for package downloads during installation.

6. Install Base System

The installer will:

Format partitions
Install base packages
Configure bootloader

This may take 30-60 minutes depending on your system and internet speed.

7. Set Root Password

When prompted, set a secure root password.

8. Create User Account

Create your primary user account:

useradd -m -G wheel username
passwd username

9. Reboot

Once installation completes:

reboot

Remove the installation media when prompted.

Post-Installation

After rebooting into your new system:

Log in with your user account
Update the system: lin update
Install additional software as needed

Troubleshooting

Boot Issues

If system won't boot:

Verify BIOS/UEFI boot order
Check bootloader configuration
Ensure partitions were formatted correctly

Network Issues

If network isn't working:

Check network cable connection
Verify network configuration
Test with: ping -c 3 lunar-linux.org

Next Steps

Learn about package management
Explore system administration