# headoop/setup-new-host architecture

> Architecture diagram of the GitHub repository headoop/setup-new-host, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/headoop/setup-new-host
- Repository: https://github.com/headoop/setup-new-host

## Overview

This repository is a set of local Ansible playbooks and roles for configuring a personal Linux computer. The main workflow is an operator running the bootstrap play, then the broader Arch setup, followed by optional desktop and service-specific plays. The README documents the principal capabilities and invocation order; source excerpts were not provided, so relationships between individual plays and roles are not inferred. The README names `05-setup-gnome.yml`, while the tree contains `05-setup-gnome-desktop.yml`; the graph uses the path present in the tree.

Main entry points: [`01-bootstrap.yml`](https://github.com/headoop/setup-new-host/blob/main/01-bootstrap.yml) (Bootstrap host), [`04-setup.yml`](https://github.com/headoop/setup-new-host/blob/main/04-setup.yml) (Full setup), [`05-setup-gnome-desktop.yml`](https://github.com/headoop/setup-new-host/blob/main/05-setup-gnome-desktop.yml) (GNOME desktop), [`06-gnome-extensions.yml`](https://github.com/headoop/setup-new-host/blob/main/06-gnome-extensions.yml) (GNOME extensions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Host setup"]
  node_bootstrap["Bootstrap host<br/>[01-bootstrap.yml]"]
  node_full_setup["Full setup<br/>[04-setup.yml]"]
end

subgraph group_desktop["Desktop setup"]
  node_desktop_setup["GNOME desktop"]
  node_extensions["GNOME extensions"]
  node_dconf["GNOME shortcuts<br/>[07-setup-dconf.yml]"]
  node_niri["Niri and DMS<br/>[15-niri-dms.yml]"]
end

subgraph group_services["Services and tools"]
  node_nextcloud["Nextcloud startup"]
  node_postfix["Command-line mail<br/>[09-postfix.yml]"]
  node_todotxt["Todo management<br/>[10-todotxt.yml]"]
  node_cups["Printing<br/>[13-cups.yml]"]
  node_mpd["Music playback<br/>[14-mpd.yml]"]
end

subgraph group_network["Network setup"]
  node_reflector["Mirror updates<br/>[11-reflector.yml]"]
  node_network_setup["Network setup"]
end

node_operator(("Host operator"))

node_operator -->|"runs first"| node_bootstrap
node_operator -->|"runs next"| node_full_setup
node_operator -->|"runs optionally"| node_desktop_setup
node_operator -->|"runs optionally"| node_extensions
node_operator -->|"runs optionally"| node_dconf
node_operator -->|"runs optionally"| node_nextcloud
node_operator -->|"runs optionally"| node_postfix
node_operator -->|"runs optionally"| node_todotxt
node_operator -->|"runs optionally"| node_reflector
node_operator -->|"runs optionally"| node_cups
node_operator -->|"runs optionally"| node_mpd

click node_bootstrap "https://github.com/headoop/setup-new-host/blob/main/01-bootstrap.yml"
click node_full_setup "https://github.com/headoop/setup-new-host/blob/main/04-setup.yml"
click node_desktop_setup "https://github.com/headoop/setup-new-host/blob/main/05-setup-gnome-desktop.yml"
click node_extensions "https://github.com/headoop/setup-new-host/blob/main/06-gnome-extensions.yml"
click node_dconf "https://github.com/headoop/setup-new-host/blob/main/07-setup-dconf.yml"
click node_nextcloud "https://github.com/headoop/setup-new-host/blob/main/08-nextcloud-client-setup.yml"
click node_postfix "https://github.com/headoop/setup-new-host/blob/main/09-postfix.yml"
click node_todotxt "https://github.com/headoop/setup-new-host/blob/main/10-todotxt.yml"
click node_reflector "https://github.com/headoop/setup-new-host/blob/main/11-reflector.yml"
click node_cups "https://github.com/headoop/setup-new-host/blob/main/13-cups.yml"
click node_mpd "https://github.com/headoop/setup-new-host/blob/main/14-mpd.yml"
click node_niri "https://github.com/headoop/setup-new-host/blob/main/15-niri-dms.yml"
click node_network_setup "https://github.com/headoop/setup-new-host/blob/main/99-setup-network.yml"

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_bootstrap,node_full_setup toneBlue
class node_desktop_setup,node_extensions,node_dconf,node_niri toneAmber
class node_nextcloud,node_postfix,node_todotxt,node_cups,node_mpd toneMint
class node_reflector,node_network_setup toneRose
class node_operator toneIndigo
```

## Components

### Host setup

- [Bootstrap host](https://github.com/headoop/setup-new-host/blob/main/01-bootstrap.yml): `01-bootstrap.yml`
- [Full setup](https://github.com/headoop/setup-new-host/blob/main/04-setup.yml): `04-setup.yml`

### Desktop setup

- [GNOME desktop](https://github.com/headoop/setup-new-host/blob/main/05-setup-gnome-desktop.yml): `05-setup-gnome-desktop.yml`
- [GNOME extensions](https://github.com/headoop/setup-new-host/blob/main/06-gnome-extensions.yml): `06-gnome-extensions.yml`
- [GNOME shortcuts](https://github.com/headoop/setup-new-host/blob/main/07-setup-dconf.yml): `07-setup-dconf.yml`
- [Niri and DMS](https://github.com/headoop/setup-new-host/blob/main/15-niri-dms.yml): `15-niri-dms.yml`

### Services and tools

- [Nextcloud startup](https://github.com/headoop/setup-new-host/blob/main/08-nextcloud-client-setup.yml): `08-nextcloud-client-setup.yml`
- [Command-line mail](https://github.com/headoop/setup-new-host/blob/main/09-postfix.yml): `09-postfix.yml`
- [Todo management](https://github.com/headoop/setup-new-host/blob/main/10-todotxt.yml): `10-todotxt.yml`
- [Printing](https://github.com/headoop/setup-new-host/blob/main/13-cups.yml): `13-cups.yml`
- [Music playback](https://github.com/headoop/setup-new-host/blob/main/14-mpd.yml): `14-mpd.yml`

### Network setup

- [Mirror updates](https://github.com/headoop/setup-new-host/blob/main/11-reflector.yml): `11-reflector.yml`
- [Network setup](https://github.com/headoop/setup-new-host/blob/main/99-setup-network.yml): `99-setup-network.yml`

### Other components

- **Host operator**

## Connections

- Host operator → Bootstrap host: runs first (evidence: `README.md`)
- Host operator → Full setup: runs next (evidence: `README.md`)
- Host operator → GNOME desktop: runs optionally (evidence: `README.md`)
- Host operator → GNOME extensions: runs optionally (evidence: `README.md`)
- Host operator → GNOME shortcuts: runs optionally (evidence: `README.md`)
- Host operator → Nextcloud startup: runs optionally (evidence: `README.md`)
- Host operator → Command-line mail: runs optionally (evidence: `README.md`)
- Host operator → Todo management: runs optionally (evidence: `README.md`)
- Host operator → Mirror updates: runs optionally (evidence: `README.md`)
- Host operator → Printing: runs optionally (evidence: `README.md`)
- Host operator → Music playback: runs optionally (evidence: `README.md`)
