# jonhill90/hill90 architecture

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

- Interactive diagram: https://gitdiagram.com/jonhill90/hill90
- Repository: https://github.com/jonhill90/hill90

## Overview

Hill90 automates provisioning and operating a single VPS platform; it is not the application hosted there. The main operator workflow prepares the host, deploys platform services, and verifies their health. Runtime capabilities include edge routing and TLS, identity and tenant data services, secrets management, and observability. The README documents these roles and several integrations; source excerpts are mostly operational checks, so the graph avoids asserting unsampled implementation-level calls.

Main entry points: [`deploy/compose/prod`](https://github.com/jonhill90/hill90/tree/main/deploy/compose/prod) (Service definitions), [`platform/edge`](https://github.com/jonhill90/hill90/tree/main/platform/edge) (Edge routing and TLS), [`scripts/deploy.sh`](https://github.com/jonhill90/hill90/blob/main/scripts/deploy.sh) (Stack deployment), [`platform/observability`](https://github.com/jonhill90/hill90/tree/main/platform/observability) (Metrics and dashboards)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_host["Host lifecycle"]
  node_provision["Host provisioning"]
  node_deploy["Stack deployment<br/>[deploy.sh]"]
  node_compose["Service definitions"]
end

subgraph group_services["Platform services"]
  node_edge["Edge routing and TLS"]
  node_auth["Identity provider"]
  node_postgres[("Platform database")]
  node_objectstore[("Object storage")]
end

subgraph group_security["Security and secrets"]
  node_secrets["Runtime secrets"]
  node_backup["Bootstrap backup"]
  node_tailscale["Tailscale access"]
end

subgraph group_operations["Operations"]
  node_monitoring["Metrics and dashboards"]
  node_alerts["Alert delivery"]
  node_backupops["Volume backup<br/>[backup.sh]"]
  node_health["Health and verification<br/>[ops.sh]"]
end

node_operator(("Operator"))
node_vps["Hostinger VPS"]
node_tenant["Tenant application"]
node_cloudflare["Cloudflare DNS"]
node_letsencrypt["Let's Encrypt"]

node_operator -->|"provisions host"| node_provision
node_provision -->|"configures host"| node_vps
node_operator -->|"deploys stacks"| node_deploy
node_deploy -->|"runs over SSH"| node_vps
node_deploy -->|"uses compose"| node_compose
node_compose -->|"defines services"| node_edge
node_compose -.->|"defines services"| node_auth
node_compose -.->|"defines services"| node_postgres
node_compose -.->|"defines services"| node_objectstore
node_edge -->|"requests certificates"| node_letsencrypt
node_edge -->|"uses DNS-01"| node_cloudflare
node_edge -->|"gates admin access"| node_tailscale
node_tenant -->|"uses identity"| node_auth
node_tenant -->|"uses database"| node_postgres
node_tenant -->|"uses storage"| node_objectstore
node_backup -->|"backs up bootstrap"| node_secrets
node_operator -->|"backs up volumes"| node_backupops
node_operator -->|"checks health"| node_health
node_monitoring -->|"routes notifications"| node_alerts
node_monitoring -->|"observes estate"| node_vps

click node_provision "https://github.com/jonhill90/hill90/tree/main/infra/ansible/playbooks"
click node_deploy "https://github.com/jonhill90/hill90/blob/main/scripts/deploy.sh"
click node_compose "https://github.com/jonhill90/hill90/tree/main/deploy/compose/prod"
click node_edge "https://github.com/jonhill90/hill90/tree/main/platform/edge"
click node_auth "https://github.com/jonhill90/hill90/tree/main/platform/auth/keycloak"
click node_postgres "https://github.com/jonhill90/hill90/tree/main/platform/data/postgres"
click node_objectstore "https://github.com/jonhill90/hill90/blob/main/deploy/compose/prod/docker-compose.minio.yml"
click node_secrets "https://github.com/jonhill90/hill90/tree/main/platform/vault"
click node_backup "https://github.com/jonhill90/hill90/tree/main/infra/secrets"
click node_monitoring "https://github.com/jonhill90/hill90/tree/main/platform/observability"
click node_alerts "https://github.com/jonhill90/hill90/blob/main/platform/observability/alertmanager/alertmanager.yml.tmpl"
click node_backupops "https://github.com/jonhill90/hill90/blob/main/scripts/backup.sh"
click node_health "https://github.com/jonhill90/hill90/blob/main/scripts/ops.sh"

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_provision,node_deploy,node_compose toneBlue
class node_edge,node_auth,node_postgres,node_objectstore toneAmber
class node_secrets,node_backup,node_tailscale toneMint
class node_monitoring,node_alerts,node_backupops,node_health toneRose
class node_operator,node_vps,node_tenant,node_cloudflare,node_letsencrypt toneIndigo
```

## Components

### Host lifecycle

- [Host provisioning](https://github.com/jonhill90/hill90/tree/main/infra/ansible/playbooks): `infra/ansible/playbooks`
- [Stack deployment](https://github.com/jonhill90/hill90/blob/main/scripts/deploy.sh): `scripts/deploy.sh`
- [Service definitions](https://github.com/jonhill90/hill90/tree/main/deploy/compose/prod): `deploy/compose/prod`

### Platform services

- [Edge routing and TLS](https://github.com/jonhill90/hill90/tree/main/platform/edge): `platform/edge`
- [Identity provider](https://github.com/jonhill90/hill90/tree/main/platform/auth/keycloak): `platform/auth/keycloak`
- [Platform database](https://github.com/jonhill90/hill90/tree/main/platform/data/postgres): `platform/data/postgres`
- [Object storage](https://github.com/jonhill90/hill90/blob/main/deploy/compose/prod/docker-compose.minio.yml): `deploy/compose/prod/docker-compose.minio.yml`

### Security and secrets

- [Runtime secrets](https://github.com/jonhill90/hill90/tree/main/platform/vault): `platform/vault`
- [Bootstrap backup](https://github.com/jonhill90/hill90/tree/main/infra/secrets): `infra/secrets`
- **Tailscale access**

### Operations

- [Metrics and dashboards](https://github.com/jonhill90/hill90/tree/main/platform/observability): `platform/observability`
- [Alert delivery](https://github.com/jonhill90/hill90/blob/main/platform/observability/alertmanager/alertmanager.yml.tmpl): `platform/observability/alertmanager/alertmanager.yml.tmpl`
- [Volume backup](https://github.com/jonhill90/hill90/blob/main/scripts/backup.sh): `scripts/backup.sh`
- [Health and verification](https://github.com/jonhill90/hill90/blob/main/scripts/ops.sh): `scripts/ops.sh`

### Other components

- **Operator**
- **Hostinger VPS**
- **Tenant application**
- **Cloudflare DNS**
- **Let's Encrypt**

## Connections

- Operator → Host provisioning: provisions host (evidence: `README.md`)
- Host provisioning → Hostinger VPS: configures host (evidence: `README.md`)
- Operator → Stack deployment: deploys stacks (evidence: `README.md`)
- Stack deployment → Hostinger VPS: runs over SSH (evidence: `README.md`)
- Stack deployment → Service definitions: uses compose (evidence: `README.md`)
- Service definitions → Edge routing and TLS: defines services (evidence: `README.md`)
- Service definitions → Identity provider: defines services
- Service definitions → Platform database: defines services
- Service definitions → Object storage: defines services
- Edge routing and TLS → Let's Encrypt: requests certificates (evidence: `README.md`)
- Edge routing and TLS → Cloudflare DNS: uses DNS-01 (evidence: `README.md`)
- Edge routing and TLS → Tailscale access: gates admin access (evidence: `README.md`)
- Tenant application → Identity provider: uses identity (evidence: `README.md`)
- Tenant application → Platform database: uses database (evidence: `README.md`)
- Tenant application → Object storage: uses storage (evidence: `README.md`)
- Bootstrap backup → Runtime secrets: backs up bootstrap (evidence: `README.md`)
- Operator → Volume backup: backs up volumes (evidence: `README.md`)
- Operator → Health and verification: checks health (evidence: `README.md`)
- Metrics and dashboards → Alert delivery: routes notifications (evidence: `README.md`)
- Metrics and dashboards → Hostinger VPS: observes estate (evidence: `README.md`)
