# Host Topology

> Generated by `scripts/docs/generate_host_topology.py` on 2026-05-12T18:32:09+00:00.

## Topology Diagram

```mermaid
flowchart TD
  phys_pve["pve\nphysical"]
  phys_raspberrypi["raspberrypi\nphysical"]
  virt_docker["docker\nvirtual"]
  phys_pve --> virt_docker
  virt_nix_cache["nix-cache\nvirtual"]
  phys_pve --> virt_nix_cache
  virt_pbs["pbs\nvirtual"]
  phys_pve --> virt_pbs
  virt_pihole["pihole\nvirtual"]
  phys_pve --> virt_pihole
  virt_server_nixos["server-nixos\nvirtual"]
  phys_pve --> virt_server_nixos
```

## Physical Hosts

| Name | Type | Role | Management | OS | Hypervisor | Location | Notes |
| --- | --- | --- | --- | --- | --- | --- | --- |
| pve | physical | proxmox | pve.sweet.home | debian | proxmox | home | Primary Proxmox VE host |
| raspberrypi | physical | edge | raspberrypi.tail13f623.ts.net | debian |  | riverglades | Raspberry Pi host |

## Virtual Hosts

| Name | Type | Role | Parent/Node | Management | OS | Notes |
| --- | --- | --- | --- | --- | --- | --- |
| docker | virtual | docker-host | pve |  | linux | Primary Docker VM |
| nix-cache | virtual | cache | pve |  | linux | Nix binary cache VM |
| pbs | virtual | backup | pve |  | linux | Proxmox Backup Server VM |
| pihole | virtual | dns | pve |  | linux | DNS filtering VM |
| server-nixos | virtual | nixos-server | pve |  | nixos | General-purpose NixOS VM |