# colet9-prog/homelab-server-base architecture

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

- Interactive diagram: https://gitdiagram.com/colet9-prog/homelab-server-base
- Repository: https://github.com/colet9-prog/homelab-server-base

## Overview

This repository appears to hold configuration for a self-hosted environment: virtual machines and networks, host firewall rules, and several application and monitoring deployments. The tree contains no README and no sampled source or configuration contents, so it does not establish how these components connect or which files are actively applied. The graph therefore groups the identifiable configuration areas without implying a runtime workflow or unsupported dependencies.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_virtualization["Virtualization & Networks"]
  node_game_servers_vm["Game Servers VM<br/>[game-servers.xml]"]
  node_games_network["Games Network"]
  node_lan_network["LAN Network"]
  node_opnsense_firewall["OPNsense Firewall"]
end

subgraph group_security["Host Security"]
  node_host_rules["Host Input Rules"]
  node_firewall_snapshot["Firewall Snapshot"]
  node_firewall_before_snapshot["Earlier Firewall Snapshot"]
end

subgraph group_applications["Applications"]
  node_npm["NPM Deployment<br/>[docker-compose.yml]"]
  node_uptime_kuma["Uptime Kuma Deployment<br/>[docker-compose.yml]"]
  node_vaultwarden["Vaultwarden Deployment<br/>[docker-compose.yml]"]
end

subgraph group_monitoring["Monitoring"]
  node_prometheus["Prometheus Deployment<br/>[docker-compose.yml]"]
  node_prometheus_config["Prometheus Configuration<br/>[prometheus.yml]"]
  node_storage_baseline["Drive SMART Baseline"]
end

click node_game_servers_vm "https://github.com/colet9-prog/homelab-server-base/blob/main/libvirt/game-servers.xml"
click node_games_network "https://github.com/colet9-prog/homelab-server-base/blob/main/libvirt/opn-games-network.xml"
click node_lan_network "https://github.com/colet9-prog/homelab-server-base/blob/main/libvirt/opn-lan-network.xml"
click node_opnsense_firewall "https://github.com/colet9-prog/homelab-server-base/blob/main/libvirt/opnsense-firewall.xml"
click node_host_rules "https://github.com/colet9-prog/homelab-server-base/blob/main/nftables/homelab-host-input.nft"
click node_firewall_snapshot "https://github.com/colet9-prog/homelab-server-base/blob/main/nftables/nft-homelab-host-active-2026-09-23-1902.txt"
click node_firewall_before_snapshot "https://github.com/colet9-prog/homelab-server-base/blob/main/nftables/nft-before-host-firewall-2026-09-23-1849.txt"
click node_npm "https://github.com/colet9-prog/homelab-server-base/blob/main/npm/docker-compose.yml"
click node_uptime_kuma "https://github.com/colet9-prog/homelab-server-base/blob/main/uptime-kuma/docker-compose.yml"
click node_vaultwarden "https://github.com/colet9-prog/homelab-server-base/blob/main/vaultwarden/docker-compose.yml"
click node_prometheus "https://github.com/colet9-prog/homelab-server-base/blob/main/monitoring/docker-compose.yml"
click node_prometheus_config "https://github.com/colet9-prog/homelab-server-base/blob/main/monitoring/prometheus.yml"
click node_storage_baseline "https://github.com/colet9-prog/homelab-server-base/blob/main/wd-blue-smart-baseline-20260922.txt"

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_game_servers_vm,node_games_network,node_lan_network,node_opnsense_firewall toneBlue
class node_host_rules,node_firewall_snapshot,node_firewall_before_snapshot toneAmber
class node_npm,node_uptime_kuma,node_vaultwarden toneMint
class node_prometheus,node_prometheus_config,node_storage_baseline toneRose
```

## Components

### Virtualization & Networks

- [Game Servers VM](https://github.com/colet9-prog/homelab-server-base/blob/main/libvirt/game-servers.xml): `libvirt/game-servers.xml`
- [Games Network](https://github.com/colet9-prog/homelab-server-base/blob/main/libvirt/opn-games-network.xml): `libvirt/opn-games-network.xml`
- [LAN Network](https://github.com/colet9-prog/homelab-server-base/blob/main/libvirt/opn-lan-network.xml): `libvirt/opn-lan-network.xml`
- [OPNsense Firewall](https://github.com/colet9-prog/homelab-server-base/blob/main/libvirt/opnsense-firewall.xml): `libvirt/opnsense-firewall.xml`

### Host Security

- [Host Input Rules](https://github.com/colet9-prog/homelab-server-base/blob/main/nftables/homelab-host-input.nft): `nftables/homelab-host-input.nft`
- [Firewall Snapshot](https://github.com/colet9-prog/homelab-server-base/blob/main/nftables/nft-homelab-host-active-2026-09-23-1902.txt): `nftables/nft-homelab-host-active-2026-09-23-1902.txt`
- [Earlier Firewall Snapshot](https://github.com/colet9-prog/homelab-server-base/blob/main/nftables/nft-before-host-firewall-2026-09-23-1849.txt): `nftables/nft-before-host-firewall-2026-09-23-1849.txt`

### Applications

- [NPM Deployment](https://github.com/colet9-prog/homelab-server-base/blob/main/npm/docker-compose.yml): `npm/docker-compose.yml`
- [Uptime Kuma Deployment](https://github.com/colet9-prog/homelab-server-base/blob/main/uptime-kuma/docker-compose.yml): `uptime-kuma/docker-compose.yml`
- [Vaultwarden Deployment](https://github.com/colet9-prog/homelab-server-base/blob/main/vaultwarden/docker-compose.yml): `vaultwarden/docker-compose.yml`

### Monitoring

- [Prometheus Deployment](https://github.com/colet9-prog/homelab-server-base/blob/main/monitoring/docker-compose.yml): `monitoring/docker-compose.yml`
- [Prometheus Configuration](https://github.com/colet9-prog/homelab-server-base/blob/main/monitoring/prometheus.yml): `monitoring/prometheus.yml`
- [Drive SMART Baseline](https://github.com/colet9-prog/homelab-server-base/blob/main/wd-blue-smart-baseline-20260922.txt): `wd-blue-smart-baseline-20260922.txt`