How omacom/omarchy-iso works
Omarchy ISO is a bootable Arch-based installer, with the installer itself living in this repository. The main path is boot the medium, load either cidata autoinstall configuration or the interactive configurator, then run the orchestrated Arch and Omarchy installation through target setup and validation. The README also documents optional SSH, Tailscale, encryption, and deferred provisioning capabilities. Orchestrator relationships are grounded in the sampled phase runner and its explicit phase list; several ISO UI and wrapper details are documented but their implementations were not sampled.
Main entry points: phases.py Phase runner · profiledef.sh Bootable ISO · main.py Phase orchestrator · archinstall_adapter.py Arch installation
Components 20
Boot and configuration
- Bootable ISO
configs/profiledef.sh - Autoinstall loader
configs/airootfs/usr/local/bin/omarchy-cidata-load - Configurator
configs/airootfs/root/configurator - Install wrapper
configs/airootfs/usr/local/bin/omarchy-iso-install - Install dashboard
configs/airootfs/usr/local/bin/omarchy-install-dashboard
Install orchestration
- Install context
configs/airootfs/usr/share/omarchy-iso/orchestrator/context.py - Phase orchestrator
configs/airootfs/usr/share/omarchy-iso/orchestrator/main.py - Phase runner
configs/airootfs/usr/share/omarchy-iso/orchestrator/phases.py - Progress output
configs/airootfs/usr/share/omarchy-iso/orchestrator/ui.py
Target system setup
- Disk preparation
configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py - Arch installation
configs/airootfs/usr/share/omarchy-iso/orchestrator/archinstall_adapter.py - System finalization
configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py - Boot configuration
configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py - User and access setup
configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py - Boot validation
configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py - Factory snapshot
configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py
External systems
- archinstall library
- Bundled package mirror
- Installed Omarchy system
Other components
- Installer user
Connections 24
- Installer user → Bootable ISO: boots
README.md - Bootable ISO → Autoinstall loader: loads configuration
README.md - Bootable ISO → Configurator: launches wizard
README.md - Autoinstall loader → Install wrapper: starts install
README.md - Configurator → Install wrapper: provides configuration
README.md - Install wrapper → Phase orchestrator: invokes
- Phase orchestrator → Install context: loads context
configs/airootfs/usr/share/omarchy-iso/orchestrator/main.py - Phase orchestrator → Phase runner: runs phases
configs/airootfs/usr/share/omarchy-iso/orchestrator/main.py - Phase runner → Progress output: reports progress
configs/airootfs/usr/share/omarchy-iso/orchestrator/phases.py - Phase runner → Install dashboard: publishes phase state
- Phase runner → Disk preparation: runs phase functions
configs/airootfs/usr/share/omarchy-iso/orchestrator/phases.py - Disk preparation → Arch installation: uses adapter
configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py - Arch installation → archinstall library: calls library
configs/airootfs/usr/share/omarchy-iso/orchestrator/archinstall_adapter.py - Arch installation → Bundled package mirror: installs packages
- Phase runner → System finalization: runs phase functions
configs/airootfs/usr/share/omarchy-iso/orchestrator/phases.py - Phase runner → Boot configuration: runs phase functions
configs/airootfs/usr/share/omarchy-iso/orchestrator/phases.py - Phase runner → User and access setup: runs phase functions
configs/airootfs/usr/share/omarchy-iso/orchestrator/phases.py - Phase runner → Boot validation: runs phase functions
configs/airootfs/usr/share/omarchy-iso/orchestrator/phases.py - Phase runner → Factory snapshot: runs phase functions
configs/airootfs/usr/share/omarchy-iso/orchestrator/phases.py - System finalization → Installed Omarchy system: configures target
- Boot configuration → Installed Omarchy system: configures boot
- User and access setup → Installed Omarchy system: configures access
- Boot validation → Installed Omarchy system: validates boot
- Factory snapshot → Installed Omarchy system: snapshots system