# eternilab/gallus architecture

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

- Interactive diagram: https://gitdiagram.com/eternilab/gallus
- Repository: https://github.com/eternilab/gallus

## Overview

Gallus builds Windows 11 installation media in a Windows build environment, then uses that media to deploy a secured system to a target machine. The README identifies MDT/LTI and PowerShell as the automation foundation, and HardeningKitty as the tool used to apply and verify hardening; it also documents compliance reports generated at the end of installation. The tree suggests supporting configuration, auditing, and report-generation components, but their wiring is not shown in the available excerpts. Accordingly, links to those components are omitted where evidence is unavailable.

Main entry points: [`scripts/HardeningScript.ps1`](https://github.com/eternilab/gallus/blob/main/scripts/HardeningScript.ps1) (System hardening), [`scripts/ReportScript.js`](https://github.com/eternilab/gallus/blob/main/scripts/ReportScript.js) (Report generation), [`bootstrap.ps1`](https://github.com/eternilab/gallus/blob/main/bootstrap.ps1) (Bootstrap), [`gallus.ps1`](https://github.com/eternilab/gallus/blob/main/gallus.ps1) (Build orchestration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_media_build["Media build"]
  node_bootstrap["Bootstrap<br/>[bootstrap.ps1]"]
  node_build["Build orchestration<br/>[gallus.ps1]"]
  node_build_config["Build settings<br/>[CustomSettings.ini]"]
  node_bootstrap_config["Bootstrap settings<br/>[Bootstrap.ini]"]
end

subgraph group_deployment["Deployment"]
  node_deployment_config["Deployment rules<br/>[Gallus_ts.xml]"]
  node_mdt["MDT / LTI"]
  node_user_names["Default user names"]
  node_copy_audit["Copy audit files"]
  node_copy_gallus["Copy Gallus files"]
end

subgraph group_hardening["Hardening and audit"]
  node_hardening["System hardening"]
  node_auditing["Security auditing<br/>[AuditingScript.ps1]"]
  node_gh_table["ANSSI rule table"]
  node_gh_data["ANSSI rule data<br/>[GHI.csv]"]
  node_hardeningkitty["HardeningKitty"]
  node_variables["Script variables<br/>[Variables.ps1]"]
end

subgraph group_reporting["Compliance reporting"]
  node_report["Report generation<br/>[ReportScript.js]"]
  node_report_style["Report styling<br/>[ReportStyle.css]"]
end

node_builder(("Build operator"))
node_target(("Target machine"))

node_builder -->|"starts build"| node_bootstrap
node_bootstrap -.->|"runs build"| node_build
node_build -->|"builds with"| node_mdt
node_mdt -->|"installs system"| node_target
node_mdt -.->|"runs hardening"| node_hardening
node_hardening -->|"uses"| node_hardeningkitty
node_mdt -.->|"runs audit"| node_auditing
node_mdt -.->|"runs customization"| node_user_names
node_mdt -.->|"copies files"| node_copy_audit
node_mdt -.->|"copies files"| node_copy_gallus
node_gh_table -.->|"reads rules"| node_gh_data
node_hardening -.->|"uses settings"| node_variables
node_mdt -.->|"generates report"| node_report
node_report -.->|"uses styles"| node_report_style
node_target -->|"displays report"| node_report

click node_bootstrap "https://github.com/eternilab/gallus/blob/main/bootstrap.ps1"
click node_build "https://github.com/eternilab/gallus/blob/main/gallus.ps1"
click node_build_config "https://github.com/eternilab/gallus/blob/main/conf/CustomSettings.ini"
click node_bootstrap_config "https://github.com/eternilab/gallus/blob/main/conf/Bootstrap.ini"
click node_deployment_config "https://github.com/eternilab/gallus/blob/main/conf/Gallus_ts.xml"
click node_hardening "https://github.com/eternilab/gallus/blob/main/scripts/HardeningScript.ps1"
click node_auditing "https://github.com/eternilab/gallus/blob/main/scripts/AuditingScript.ps1"
click node_gh_table "https://github.com/eternilab/gallus/blob/main/scripts/GenerateGHITable.ps1"
click node_gh_data "https://github.com/eternilab/gallus/blob/main/scripts/GHI.csv"
click node_variables "https://github.com/eternilab/gallus/blob/main/scripts/Variables.ps1"
click node_user_names "https://github.com/eternilab/gallus/blob/main/scripts/ChangeDefaultUsersNames.ps1"
click node_copy_audit "https://github.com/eternilab/gallus/blob/main/scripts/CopyAuditingFiles.ps1"
click node_copy_gallus "https://github.com/eternilab/gallus/blob/main/scripts/CopyGallusFiles.wsf"
click node_report "https://github.com/eternilab/gallus/blob/main/scripts/ReportScript.js"
click node_report_style "https://github.com/eternilab/gallus/blob/main/scripts/ReportStyle.css"

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_build,node_build_config,node_bootstrap_config toneBlue
class node_deployment_config,node_mdt,node_user_names,node_copy_audit,node_copy_gallus toneAmber
class node_hardening,node_auditing,node_gh_table,node_gh_data,node_hardeningkitty,node_variables toneMint
class node_report,node_report_style toneRose
class node_builder,node_target toneIndigo
```

## Components

### Media build

- [Bootstrap](https://github.com/eternilab/gallus/blob/main/bootstrap.ps1): `bootstrap.ps1`
- [Build orchestration](https://github.com/eternilab/gallus/blob/main/gallus.ps1): `gallus.ps1`
- [Build settings](https://github.com/eternilab/gallus/blob/main/conf/CustomSettings.ini): `conf/CustomSettings.ini`
- [Bootstrap settings](https://github.com/eternilab/gallus/blob/main/conf/Bootstrap.ini): `conf/Bootstrap.ini`

### Deployment

- [Deployment rules](https://github.com/eternilab/gallus/blob/main/conf/Gallus_ts.xml): `conf/Gallus_ts.xml`
- **MDT / LTI**
- [Default user names](https://github.com/eternilab/gallus/blob/main/scripts/ChangeDefaultUsersNames.ps1): `scripts/ChangeDefaultUsersNames.ps1`
- [Copy audit files](https://github.com/eternilab/gallus/blob/main/scripts/CopyAuditingFiles.ps1): `scripts/CopyAuditingFiles.ps1`
- [Copy Gallus files](https://github.com/eternilab/gallus/blob/main/scripts/CopyGallusFiles.wsf): `scripts/CopyGallusFiles.wsf`

### Hardening and audit

- [System hardening](https://github.com/eternilab/gallus/blob/main/scripts/HardeningScript.ps1): `scripts/HardeningScript.ps1`
- [Security auditing](https://github.com/eternilab/gallus/blob/main/scripts/AuditingScript.ps1): `scripts/AuditingScript.ps1`
- [ANSSI rule table](https://github.com/eternilab/gallus/blob/main/scripts/GenerateGHITable.ps1): `scripts/GenerateGHITable.ps1`
- [ANSSI rule data](https://github.com/eternilab/gallus/blob/main/scripts/GHI.csv): `scripts/GHI.csv`
- **HardeningKitty**
- [Script variables](https://github.com/eternilab/gallus/blob/main/scripts/Variables.ps1): `scripts/Variables.ps1`

### Compliance reporting

- [Report generation](https://github.com/eternilab/gallus/blob/main/scripts/ReportScript.js): `scripts/ReportScript.js`
- [Report styling](https://github.com/eternilab/gallus/blob/main/scripts/ReportStyle.css): `scripts/ReportStyle.css`

### Other components

- **Build operator**
- **Target machine**

## Connections

- Build operator → Bootstrap: starts build (evidence: `README.md`)
- Bootstrap → Build orchestration: runs build
- Build orchestration → MDT / LTI: builds with (evidence: `README.md`)
- MDT / LTI → Target machine: installs system (evidence: `README.md`)
- MDT / LTI → System hardening: runs hardening
- System hardening → HardeningKitty: uses (evidence: `README.md`)
- MDT / LTI → Security auditing: runs audit
- MDT / LTI → Default user names: runs customization
- MDT / LTI → Copy audit files: copies files
- MDT / LTI → Copy Gallus files: copies files
- ANSSI rule table → ANSSI rule data: reads rules
- System hardening → Script variables: uses settings
- MDT / LTI → Report generation: generates report
- Report generation → Report styling: uses styles
- Target machine → Report generation: displays report (evidence: `README.md`)
