# omacom/omarchy-iso architecture

> Architecture diagram of the GitHub repository omacom/omarchy-iso, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/omacom/omarchy-iso
- Repository: https://github.com/omacom/omarchy-iso

## Overview

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: [`configs/airootfs/usr/share/omarchy-iso/orchestrator/phases.py`](https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/phases.py) (Phase runner), [`configs/profiledef.sh`](https://github.com/omacom/omarchy-iso/blob/quattro/configs/profiledef.sh) (Bootable ISO), [`configs/airootfs/usr/share/omarchy-iso/orchestrator/main.py`](https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/main.py) (Phase orchestrator), [`configs/airootfs/usr/share/omarchy-iso/orchestrator/archinstall_adapter.py`](https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/archinstall_adapter.py) (Arch installation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Boot and configuration"]
  node_iso["Bootable ISO<br/>[profiledef.sh]"]
  node_auto["Autoinstall loader"]
  node_configurator["Configurator"]
  node_install_cmd["Install wrapper"]
  node_dashboard["Install dashboard"]
end

subgraph group_install["Install orchestration"]
  node_context["Install context<br/>[context.py]"]
  node_orchestrator["Phase orchestrator<br/>[main.py]"]
  node_phase_runner["Phase runner<br/>[phases.py]"]
  node_progress["Progress output<br/>[ui.py]"]
end

subgraph group_target["Target system setup"]
  node_disk_setup["Disk preparation<br/>[phases_impl.py]"]
  node_arch_install["Arch installation"]
  node_system_setup["System finalization<br/>[phases_impl.py]"]
  node_boot_setup["Boot configuration<br/>[phases_impl.py]"]
  node_user_setup["User and access setup<br/>[phases_impl.py]"]
  node_boot_validation["Boot validation<br/>[phases_impl.py]"]
  node_factory_snapshot["Factory snapshot<br/>[phases_impl.py]"]
end

subgraph group_integrations["External systems"]
  node_archinstall_lib["archinstall library"]
  node_package_mirror[("Bundled package mirror")]
  node_installed_system[("Installed Omarchy system")]
end

node_user(("Installer user"))

node_user -->|"boots"| node_iso
node_iso -->|"loads configuration"| node_auto
node_iso -->|"launches wizard"| node_configurator
node_auto -->|"starts install"| node_install_cmd
node_configurator -->|"provides configuration"| node_install_cmd
node_install_cmd -.->|"invokes"| node_orchestrator
node_orchestrator -->|"loads context"| node_context
node_orchestrator -->|"runs phases"| node_phase_runner
node_phase_runner -->|"reports progress"| node_progress
node_phase_runner -.->|"publishes phase state"| node_dashboard
node_phase_runner -->|"runs phase functions"| node_disk_setup
node_disk_setup -.->|"uses adapter"| node_arch_install
node_arch_install -->|"calls library"| node_archinstall_lib
node_arch_install -.->|"installs packages"| node_package_mirror
node_phase_runner -->|"runs phase functions"| node_system_setup
node_phase_runner -->|"runs phase functions"| node_boot_setup
node_phase_runner -->|"runs phase functions"| node_user_setup
node_phase_runner -->|"runs phase functions"| node_boot_validation
node_phase_runner -->|"runs phase functions"| node_factory_snapshot
node_system_setup -.->|"configures target"| node_installed_system
node_boot_setup -.->|"configures boot"| node_installed_system
node_user_setup -.->|"configures access"| node_installed_system
node_boot_validation -.->|"validates boot"| node_installed_system
node_factory_snapshot -.->|"snapshots system"| node_installed_system

click node_iso "https://github.com/omacom/omarchy-iso/blob/quattro/configs/profiledef.sh"
click node_auto "https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/local/bin/omarchy-cidata-load"
click node_configurator "https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/root/configurator"
click node_install_cmd "https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/local/bin/omarchy-iso-install"
click node_dashboard "https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/local/bin/omarchy-install-dashboard"
click node_context "https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/context.py"
click node_orchestrator "https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/main.py"
click node_phase_runner "https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/phases.py"
click node_progress "https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/ui.py"
click node_disk_setup "https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py"
click node_arch_install "https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/archinstall_adapter.py"
click node_system_setup "https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py"
click node_boot_setup "https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py"
click node_user_setup "https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py"
click node_boot_validation "https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py"
click node_factory_snapshot "https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_iso,node_auto,node_configurator,node_install_cmd,node_dashboard,node_user toneBlue
class node_context,node_orchestrator,node_phase_runner,node_progress toneAmber
class node_disk_setup,node_arch_install,node_system_setup,node_boot_setup,node_user_setup,node_boot_validation,node_factory_snapshot toneMint
class node_archinstall_lib,node_package_mirror,node_installed_system toneRose
```

## Components

### Boot and configuration

- [Bootable ISO](https://github.com/omacom/omarchy-iso/blob/quattro/configs/profiledef.sh): `configs/profiledef.sh`
- [Autoinstall loader](https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/local/bin/omarchy-cidata-load): `configs/airootfs/usr/local/bin/omarchy-cidata-load`
- [Configurator](https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/root/configurator): `configs/airootfs/root/configurator`
- [Install wrapper](https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/local/bin/omarchy-iso-install): `configs/airootfs/usr/local/bin/omarchy-iso-install`
- [Install dashboard](https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/local/bin/omarchy-install-dashboard): `configs/airootfs/usr/local/bin/omarchy-install-dashboard`

### Install orchestration

- [Install context](https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/context.py): `configs/airootfs/usr/share/omarchy-iso/orchestrator/context.py`
- [Phase orchestrator](https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/main.py): `configs/airootfs/usr/share/omarchy-iso/orchestrator/main.py`
- [Phase runner](https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/phases.py): `configs/airootfs/usr/share/omarchy-iso/orchestrator/phases.py`
- [Progress output](https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/ui.py): `configs/airootfs/usr/share/omarchy-iso/orchestrator/ui.py`

### Target system setup

- [Disk preparation](https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py): `configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py`
- [Arch installation](https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/archinstall_adapter.py): `configs/airootfs/usr/share/omarchy-iso/orchestrator/archinstall_adapter.py`
- [System finalization](https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py): `configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py`
- [Boot configuration](https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py): `configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py`
- [User and access setup](https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py): `configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py`
- [Boot validation](https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py): `configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py`
- [Factory snapshot](https://github.com/omacom/omarchy-iso/blob/quattro/configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py): `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

- Installer user → Bootable ISO: boots (evidence: `README.md`)
- Bootable ISO → Autoinstall loader: loads configuration (evidence: `README.md`)
- Bootable ISO → Configurator: launches wizard (evidence: `README.md`)
- Autoinstall loader → Install wrapper: starts install (evidence: `README.md`)
- Configurator → Install wrapper: provides configuration (evidence: `README.md`)
- Install wrapper → Phase orchestrator: invokes
- Phase orchestrator → Install context: loads context (evidence: `configs/airootfs/usr/share/omarchy-iso/orchestrator/main.py`)
- Phase orchestrator → Phase runner: runs phases (evidence: `configs/airootfs/usr/share/omarchy-iso/orchestrator/main.py`)
- Phase runner → Progress output: reports progress (evidence: `configs/airootfs/usr/share/omarchy-iso/orchestrator/phases.py`)
- Phase runner → Install dashboard: publishes phase state
- Phase runner → Disk preparation: runs phase functions (evidence: `configs/airootfs/usr/share/omarchy-iso/orchestrator/phases.py`)
- Disk preparation → Arch installation: uses adapter (evidence: `configs/airootfs/usr/share/omarchy-iso/orchestrator/phases_impl.py`)
- Arch installation → archinstall library: calls library (evidence: `configs/airootfs/usr/share/omarchy-iso/orchestrator/archinstall_adapter.py`)
- Arch installation → Bundled package mirror: installs packages
- Phase runner → System finalization: runs phase functions (evidence: `configs/airootfs/usr/share/omarchy-iso/orchestrator/phases.py`)
- Phase runner → Boot configuration: runs phase functions (evidence: `configs/airootfs/usr/share/omarchy-iso/orchestrator/phases.py`)
- Phase runner → User and access setup: runs phase functions (evidence: `configs/airootfs/usr/share/omarchy-iso/orchestrator/phases.py`)
- Phase runner → Boot validation: runs phase functions (evidence: `configs/airootfs/usr/share/omarchy-iso/orchestrator/phases.py`)
- Phase runner → Factory snapshot: runs phase functions (evidence: `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
