# 🌐 Network Topology

## Overview

This document shows the physical and logical network layout across all homelab locations, connected via Tailscale VPN mesh.

---

## 🗺️ Geographic Overview (Mermaid)

```mermaid
graph TB
    subgraph Internet["☁️ Internet"]
        ISP1["Concord Primary<br/>25Gbps Fiber"]
        ISP2["Concord Backup<br/>2G↓/500M↑"]
        ISP3["Tucson ISP"]
        ISP4["Honolulu ISP"]
        CONTABO["Contabo Cloud<br/>Seattle"]
    end

    subgraph Concord_Primary["🏠 Concord, CA - Primary (25Gbps)"]
        TPLINK["TP-Link Archer BE800<br/>Tri-Band Router"]
        SWITCH["TP-Link TL-SX1008<br/>10GbE Switch"]
        
        subgraph NAS_Cluster["📦 NAS Cluster"]
            ATLANTIS["Atlantis<br/>DS1823xs+<br/>8x16TB"]
            CALYPSO["Calypso<br/>DS723+<br/>2x12TB"]
        end
        
        subgraph Compute["💻 Compute"]
            GUAVA["Guava<br/>TrueNAS Scale<br/>Ryzen 5 8600G"]
            DESKTOP["Shinku-Ryuu<br/>i7-14700K + RTX 4080<br/>96GB DDR5"]
            PROXMOX["Proxmox Host"]
            OLARES["Olares<br/>Core Ultra 9 275HX<br/>RTX 5090, 96GB"]
        end
        
        subgraph Edge_Primary["📡 Edge Devices"]
            PI_VISH["RPi 5<br/>(Vish)"]
            GL_BERYL7["GL-MT3600BE (Beryl 7)<br/>remote router / exit<br/>192.168.12.0/24"]
            GL_BE["GL-BE3600<br/>router / exit node<br/>192.168.8.0/24"]
        end
        
        subgraph VMs["🖥️ Virtual Machines"]
            HOMELAB_VM["Homelab VM"]
            MATRIX_VM["matrix-ubuntu<br/>(on Atlantis)"]
        end
    end

    subgraph Concord_Backup["🏠 Concord, CA - Backup ISP (2G/500M)"]
        NUC["Concord NUC<br/>Intel NUC"]
        PI_KEVIN["RPi 5<br/>(Kevin)"]
    end

    subgraph Tucson["🌵 Tucson, AZ"]
        SETILLO["Setillo<br/>DS223j<br/>2x10TB WD Gold"]
    end

    subgraph Honolulu["🌺 Honolulu, HI"]
        BCPF["bluecrownpassionflower<br/>Sibling's PC"]
    end

    subgraph Mobile["✈️ Mobile/Travel"]
        MSI["MSI Laptop<br/>Portable Workstation"]
    end

    subgraph Seattle["🌲 Seattle, WA (Cloud)"]
        CONTABO_VM["Contabo VM<br/>Cloud VPS"]
    end

    %% Internet connections
    ISP1 --> TPLINK
    ISP2 --> NUC
    ISP3 --> SETILLO
    ISP4 --> BCPF
    CONTABO --> CONTABO_VM

    %% Concord Primary internal
    TPLINK --> SWITCH
    SWITCH -->|10GbE| ATLANTIS
    SWITCH -->|10GbE| CALYPSO
    SWITCH -->|10GbE| GUAVA
    SWITCH -->|10GbE| DESKTOP
    TPLINK -->|2.5GbE| PROXMOX
    TPLINK -->|2.5GbE| OLARES
    TPLINK -->|1GbE| PI_VISH
    TPLINK -.->|Tailscale| GL_BERYL7
    TPLINK -->|1GbE| GL_BE
    PROXMOX --> HOMELAB_VM
    ATLANTIS -->|VMM| MATRIX_VM

    %% Tailscale/Headscale mesh (dashed)
    ATLANTIS -.->|Headscale| SETILLO
    ATLANTIS -.->|Headscale| NUC
    ATLANTIS -.->|Headscale| BCPF
    ATLANTIS -.->|Headscale| CONTABO_VM
    ATLANTIS -.->|Headscale| MSI

    classDef nas fill:#4a9eff,stroke:#333,stroke-width:2px,color:#fff
    classDef compute fill:#9b59b6,stroke:#333,stroke-width:2px,color:#fff
    classDef network fill:#2ecc71,stroke:#333,stroke-width:2px,color:#fff
    classDef vm fill:#e74c3c,stroke:#333,stroke-width:2px,color:#fff
    classDef cloud fill:#f39c12,stroke:#333,stroke-width:2px,color:#fff
    classDef edge fill:#1abc9c,stroke:#333,stroke-width:2px,color:#fff

    class ATLANTIS,CALYPSO,SETILLO nas
    class GUAVA,DESKTOP,PROXMOX,OLARES compute
    class TPLINK,SWITCH,GL_BERYL7,GL_BE network
    class HOMELAB_VM,MATRIX_VM vm
    class CONTABO_VM cloud
    class NUC,PI_KEVIN,PI_VISH edge
```

---

## 📝 ASCII Network Topology

```
╔══════════════════════════════════════════════════════════════════════════════════════════╗
║                           HOMELAB NETWORK TOPOLOGY                                        ║
║                        4 Locations • Tailscale Mesh • 25Gbps Primary                     ║
╚══════════════════════════════════════════════════════════════════════════════════════════╝

┌─────────────────────────────────────────────────────────────────────────────────────────┐
│  ☁️  INTERNET                                                                            │
│  ═══════════════════════════════════════════════════════════════════════════════════════│
│                                                                                          │
│    [Concord 25G]     [Concord 2G/500M]     [Tucson]      [Honolulu]      [Seattle]      │
│         │                   │                  │              │              │           │
│         ▼                   ▼                  ▼              ▼              ▼           │
└─────────┼───────────────────┼──────────────────┼──────────────┼──────────────┼───────────┘
          │                   │                  │              │              │
          │                   │                  │              │              │
┌─────────▼───────────────────┼──────────────────┼──────────────┼──────────────┼───────────┐
│  🏠 CONCORD, CA (PRIMARY)   │                  │              │              │           │
│  ════════════════════════   │                  │              │              │           │
│                             │                  │              │              │           │
│  ┌──────────────────┐       │                  │              │              │           │
│  │ TP-Link Archer BE800  │       │                  │              │              │           │
│  │  (Tri-Band WiFi) │       │                  │              │              │           │
│  └────────┬─────────┘       │                  │              │              │           │
│           │                 │                  │              │              │           │
│           ▼                 │                  │              │              │           │
│  ┌──────────────────┐       │                  │              │              │           │
│  │ TL-SX1008 10GbE  │       │                  │              │              │           │
│  │    8-Port Switch │       │                  │              │              │           │
│  └┬───┬───┬───┬─────┘       │                  │              │              │           │
│   │   │   │   │             │                  │              │              │           │
│   │   │   │   └─────────────┼──────────────────┼──────────────┼──────────────┼───────────┤
│   │   │   │    10GbE        │                  │              │              │           │
│   ▼   ▼   ▼   ▼             │                  │              │              │           │
│ ┌───┐┌───┐┌───┐┌───┐        │                  │              │              │           │
│ │ATL││CAL││GUA││DSK│        │                  │              │              │           │
│ │   ││   ││   ││   │        │                  │              │              │           │
│ │8x ││2x ││   ││   │        │                  │              │              │           │
│ │16T││12T││   ││   │        │                  │              │              │           │
│ └───┘└───┘└───┘└───┘        │                  │              │              │           │
│                             │                  │              │              │           │
│  ┌─────────────────┐        │                  │              │              │           │
│  │  Proxmox Host   │        │                  │              │              │           │
│  │  ┌───────────┐  │        │                  │              │              │           │
│  │  │ Homelab VM│  │        │                  │              │              │           │
│  │  └───────────┘  │        │                  │              │              │           │
│  └─────────────────┘        │                  │              │              │           │
│                             │                  │              │              │           │
│  ┌─────────────────┐        │                  │              │              │           │
│  │ GL-BE3600       │        │                  │              │              │           │
│  │ (exit node)     │        │                  │              │              │           │
│  └─────────────────┘        │                  │              │              │           │
│  ┌─────────────────┐        │                  │              │              │           │
│  │ GL-MT3600BE     │        │                  │              │              │           │
│  │ (Beryl 7, remote│        │                  │              │              │           │
│  │  subnet router) │        │                  │              │              │           │
│  └─────────────────┘        │                  │              │              │           │
│  ┌─────────────────┐        │                  │              │              │           │
│  │ Olares          │        │                  │              │              │           │
│  │ (K8s, LLM)     │        │                  │              │              │           │
│  └─────────────────┘        │                  │              │              │           │
│  ┌─────────────────┐        │                  │              │              │           │
│  │ RPi 5 (Vish)   │        │                  │              │              │           │
│  │ (monitoring)    │        │                  │              │              │           │
│  └─────────────────┘        │                  │              │              │           │
│                             │                  │              │              │           │
└─────────────────────────────┼──────────────────┼──────────────┼──────────────┼───────────┘
                              │                  │              │              │
┌─────────────────────────────▼──────────────────┼──────────────┼──────────────┼───────────┐
│  🏠 CONCORD BACKUP ISP                         │              │              │           │
│  ════════════════════════                      │              │              │           │
│  ┌─────────┐  ┌─────────┐                      │              │              │           │
│  │ Concord │  │  RPi 5  │                      │              │              │           │
│  │   NUC   │  │ (Kevin) │                      │              │              │           │
│  └─────────┘  └─────────┘                      │              │              │           │
└────────────────────────────────────────────────┼──────────────┼──────────────┼───────────┘
                                                 │              │              │
┌────────────────────────────────────────────────▼──────────────┼──────────────┼───────────┐
│  🌵 TUCSON, AZ                                                │              │           │
│  ════════════════                                             │              │           │
│  ┌─────────────┐                                              │              │           │
│  │   Setillo   │◄─ ─ ─ ─ ─ ─ ─ ─ ─Tailscale─ ─ ─ ─ ─ ─ ─ ─ ─ ┤              │           │
│  │ Synology NAS│                                              │              │           │
│  └─────────────┘                                              │              │           │
└───────────────────────────────────────────────────────────────┼──────────────┼───────────┘
                                                                │              │
┌───────────────────────────────────────────────────────────────▼──────────────┼───────────┐
│  🌺 HONOLULU, HI                                                            │           │
│  ════════════════                                                            │           │
│  ┌──────────────────────┐                                                    │           │
│  │ bluecrownpassionflower│◄─ ─ ─ ─Headscale─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┤           │
│  │                      │                                                    │           │
│  └──────────────────────┘                                                    │           │
└──────────────────────────────────────────────────────────────────────────────┼───────────┘
                                                                               │
┌──────────────────────────────────────────────────────────────────────────────▼───────────┐
│  🌲 SEATTLE, WA (CLOUD)                                                                  │
│  ══════════════════════                                                                  │
│  ┌─────────────┐                                                                         │
│  │ Contabo VM  │◄─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─Tailscale─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┤
│  │ Cloud VPS   │                                                                         │
│  └─────────────┘                                                                         │
└──────────────────────────────────────────────────────────────────────────────────────────┘

╔════════════════════════════════════════════════════════════════════════════════════════╗
║  LEGEND                                                                                 ║
║  ══════                                                                                 ║
║  ATL = Atlantis (DS1823xs+)    CAL = Calypso (DS723+)    GUA = Guava (TrueNAS)         ║
║  DSK = Shinku-Ryuu Desktop      HLB = Homelab VM          ─── = Physical Connection     ║
║  GL-BE = GL-BE3600 (exit node)  Beryl 7 = GL-MT3600BE (remote) ─ ─ = Headscale VPN    ║
║                                                                                         ║
║  10GbE connections: Atlantis, Calypso, Guava, Desktop                                  ║
║  All other connections: 1GbE or WiFi                                                    ║
╚════════════════════════════════════════════════════════════════════════════════════════╝
```

---

## 📊 Connection Summary

### Concord Primary (25Gbps Fiber)
| Device | Connection | Speed | Purpose |
|--------|------------|-------|---------|
| Atlantis | TL-SX1008 | 10GbE | Primary NAS, media, services |
| Calypso | TL-SX1008 | 10GbE | Secondary NAS, development |
| Guava | TL-SX1008 | 10GbE | Physical compute host |
| Desktop | TL-SX1008 | 10GbE | Workstation |
| Proxmox | TP-Link Router | 2.5GbE | VM host |
| Olares | TP-Link Router | 2.5GbE | K8s, LLM inference |
| RPi 5 (Vish) | TP-Link Router | 1GbE | Monitoring, uptime |

### Concord Backup (2Gbps/500Mbps)
| Device | Connection | Speed | Purpose |
|--------|------------|-------|---------|
| Concord NUC | Direct | 1GbE | Edge computing, failover |
| RPi 5 (Kevin) | Direct | 1GbE | Lightweight services |

### Remote Locations
| Location | Device | Connection | Purpose |
|----------|--------|------------|---------|
| Tucson | Setillo (DS223j) | Headscale | Remote NAS, offsite backup |
| Honolulu | bluecrownpassionflower | Headscale | Sibling's PC |
| Seattle | Contabo VPS (seattle) | Headscale | Cloud services, exit node |

---

## 🔗 Related Diagrams
- [Tailscale Mesh](tailscale-mesh.md) - VPN overlay network details
- [10GbE Backbone](10gbe-backbone.md) - High-speed internal network
- [Location Overview](location-overview.md) - Geographic distribution