Files
itpp-infrastructure/docs/architecture.md
T
Sho'Nuff d4e3777959 Add live-truth architecture reference doc
Replaces the archived master-apps-services.md (Jul 16, 2026) which
listed 10+ defunct servers and stale specs (Mattermost, wphost01,
standalone hudu, etc.). This is the new single source of truth.

Cross-references deployment docs being created in org-audit.
2026-08-09 01:16:24 -04:00

5.9 KiB

IT Pro Partner — Live Architecture Reference

Last Updated: 2026-08-09 Maintainer: Sho'Nuff (Hermes Agent) Purpose: Single source of truth for ITPP server infrastructure. Replaces the archived master-apps-services.md (Jul 16, 2026) which listed 10+ defunct servers and stale specs.


Servers

Server IP Specs Provider Role
Core 152.53.192.33 RS 2000 G9.5 (8 vCPU EPYC 9645, 15 GB RAM, 256 GB SSD) netcup Hermes agent host, monitoring, Caddy reverse proxy (26 sites)
app1 152.53.36.131 RS 4000 G9.5 (8 vCPU EPYC, 16 GB RAM, 512 GB SSD) netcup Service hub — AI gateway, CRM, signing, TTS, auth, automation
app2 152.53.39.202 RS 4000 G9.5 (8 vCPU EPYC, 16 GB RAM, 512 GB SSD) netcup Infrastructure — Gitea, Hudu, Ubiquiti controllers, Traccar, DNS, SIEM
app3 152.53.241.111 RS 4000 G9.5 (8 vCPU EPYC, 16 GB RAM, 512 GB SSD) netcup Web hosting — CloudPanel CE (WordPress/static/PHP), client sites
app1-bu 5.161.225.131 CPX21 (3 vCPU, 4 GB RAM, 80 GB) Hetzner Warm standby — provider diversity. Auto-restores from S3.

Services by Server

Core (152.53.192.33)

Service Port Type Docs
Hermes Agent Systemd See hermes-agent skill
Caddy 80, 443 Systemd /etc/caddy/Caddyfile
Prometheus 9090 (internal) Docker
Grafana :3002 Docker Credential in Vaultwarden
Uptime Kuma :3001 Docker
Telegraf Docker
MikroTik Exporter :9436 Docker
Microbin Docker
Browserless Docker
Camofox Browser :9377 Docker
Mealie 9925 (internal) Docker

App1 (152.53.36.131)

Service Port Type Docs
LiteLLM :4000 Docker In progress — org-audit/docs/services/litellm-deployment.md
Twenty CRM 3000 Docker (4 containers: server, worker, db, redis) In progress — org-audit/docs/services/twenty-crm-deployment.md
DocuSeal Docker
Kokoro TTS :8880 Docker
n8n Docker
Open WebUI Docker
Vaultwarden :8081 Docker In progress — org-audit/docs/services/vaultwarden-deployment.md
Wazuh :5601 Docker (3 containers: dashboard, indexer, manager) In progress — org-audit/docs/services/wazuh-deployment.md
Komodo :9120 Docker

App2 (152.53.39.202)

Service Port Type Docs
Gitea :3001 Docker In progress — org-audit/docs/services/gitea-deployment.md
Hudu :3000 Docker
UNMS (UISP) :6443 Docker
UniFi :8443 Docker
Traccar :8082 Docker Verified operational 2026-08-09
Technitium DNS :5380 Docker In progress — org-audit/docs/services/technitium-dns-deployment.md
RAGFlow Docker
Dawarich :3002 Docker
searxng 9925 (internal) Docker

App3 (152.53.241.111)

Service Port Type Docs
CloudPanel CE Systemd (nginx + PHP-FPM)
WordPress sites 80, 443 nginx Per-site in CloudPanel
Static HTML sites 80, 443 nginx Per-site in CloudPanel

DNS & Domains

Domain Registrar DNS Provider Notes
itpropartner.com Cloudflare SiteGround (external) Cloudflare zone has no authority — records must be set at SiteGround
iamgmb.com Cloudflare Cloudflare Grey-cloud only (no proxy). Zone: f1fb2d357b8ff0fab54c5856130ec9ed
germainebrown.com Cloudflare Cloudflare Personal domain
fleettracker360.com Cloudflare Cloudflare Zone: d1830faef5a6d83365360fa925feeb13. Orange-cloud proxy → app2
debt... (DRE) Cloudflare Cloudflare Access-protected
hotnow.io Cloudflare Cloudflare Registered Aug 2026. No deployment yet.

Backup Schedule

Source Target Frequency Script
Core Hermes (live sync) s3://hermes-vps-backups/live/ Every 15 min hermes-live-sync
Core Hermes (full) s3://hermes-vps-backups/hermes-full-backup/ Daily 1:00 AM hermes-backup.sh
App1 S3 Daily 2:00 AM Cron on app1
App2 S3 Daily 2:30 AM Cron on app2
App3 S3 Daily 3:00 AM Cron on app3

S3 target: Wasabi s3.us-east-1.wasabisys.com, bucket hermes-vps-backups.


Key Repositories

Repo Gitea URL Purpose
itpp-infrastructure ippadmin/itpp-infrastructure Infrastructure docs and scripts
disaster-recovery ippadmin/disaster-recovery DR plans, runbooks, issue log
hermes-skills ippadmin/hermes-skills Hermes Agent skills (⚠️ plaintext secrets — see security note)
hermes-recovery ippadmin/hermes-recovery Hermes recovery bundles (⚠️ plaintext secrets — see security note)
org-audit ippadmin/org-audit External audit exports and deployment docs
homelab ippadmin/homelab Home lab documentation

Security Notes

  1. hermes-recovery and hermes-skills contain plaintext API keys in Git history — CRITICAL. Requires key rotation + history purge. The actual API keys must be rotated before purging since clones may exist.
  2. Vaultwarden is the sole credential store — deployment docs are in progress.
  3. LiteLLM routes all AI model traffic — deployment docs are in progress.
  4. Wazuh is the security monitoring infrastructure — deployment docs are in progress.
  5. Technitium DNS is authoritative for internal zones — no zone file backup procedure documented yet.

Changelog

  • 2026-08-09: Created as replacement for archived master-apps-services.md. Corrected server specs, removed defunct servers, added documentation cross-references.
  • 2026-07-28: Original master-apps-services.md archived (stale — listed Mattermost, wphost01, standalone hudu, incorrect specs).