How the Installer Works (End-to-End Flow)

This section dives into the finishing phase of Omarchy’s installation process. After all packages, configurations, and migrations have been applied, the installer hands off to a dedicated script that presents a final message, cleans up temporary privileges, and reboots the system to complete setup.

1. Finalizing Setup

Once the main install.sh script has finished applying all packages, themes, and user configurations, it invokes the finishing script. This handoff marks the transition from setup to system reboot.

# In install.sh, as the last step:
# Finish
source $OMARCHY_INSTALL/reboot.sh

This ensures any final display and cleanup logic is centralized in install/reboot.sh .

2. Cleanup Tasks

Before rebooting, the installer performs housekeeping to leave the system in a clean state:

Remove temporary sudoers entry
If the installer had set up a /etc/sudoers.d/99-omarchy-installer file for passwordless operations, it is deleted to restore normal privilege controls.
Remind user to eject installer media
After cleanup, the script echoes a reminder to remove any USB installer to prevent accidental reboots back into the installer environment.

3. Reboot Execution

With cleanup tasks complete, the installer:

Displays a farewell message using a typewriter effect for flair.
Pauses for a few seconds, letting the user read the message.
Triggers a system reboot to apply kernel updates and new configurations on first boot.

This flow ensures the user sees a clear indication that the system is ready to restart.

4. Flowchart Overview

flowchart TD
    A[All installation steps completed] --> B(Display Logo & Animation)
    B --> C(Show finish message)
    C --> D(Cleanup sudoers entry)
    D --> E(Pause for 5 seconds)
    E --> F(Invoke reboot)

5. Script Reference: `reboot.sh`

Path: install/reboot.sh
This Bash script drives the final user interaction and system reboot .

#!/bin/bash

# Clear the screen and show the Omarchy logo with a laser animation
clear
tte -i ~/.local/share/omarchy/logo.txt --frame-rate 920 laser
echo
echo "You're done! So we're ready to reboot now..." | tte --frame-rate 640 wipe

# Remove temporary installer sudoers if present
if sudo test -f /etc/sudoers.d/99-omarchy-installer; then
  sudo rm -f /etc/sudoers.d/99-omarchy-installer &>/dev/null
  echo -e "\nRemember to remove USB installer!\n\n"
fi

# Wait for user to read the message
sleep 5

# Reboot the system
reboot

Key Responsibilities

Visual Feedback: Uses tte to animate both logo and message.
Privilege Cleanup: Ensures no lingering password-less sudo privileges remain.
Controlled Delay: A 5-second pause gives users time to read final prompts.
Reboot Trigger: Calls reboot to finalize the installation.

With this, Omarchy completes its end-to-end installation cycle, handing off a freshly configured, Hyprland-based desktop ready for first use.

Search this space