Files
homelab-optimized/docs/diagrams/network-topology.md
Gitea Mirror Bot df23958959
Some checks failed
Documentation / Build Docusaurus (push) Failing after 5m2s
Documentation / Deploy to GitHub Pages (push) Has been skipped
Sanitized mirror from private repository - 2026-04-20 01:10:52 UTC
2026-04-20 01:10:52 +00:00

21 KiB

🌐 Network Topology

Overview

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


🗺️ Geographic Overview (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 (Slate 7)<br/>travel router / exit<br/>(exit-node only)"]
            GL_MT3000["GL-MT3000 (Beryl AX)<br/>travel router / exit<br/>repeater on Beryl 7"]
        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-MT3600BE     │        │                  │              │              │           │
│  │ (Beryl 7, remote│        │                  │              │              │           │
│  │  subnet router) │        │                  │              │              │           │
│  └─────────────────┘        │                  │              │              │           │
│  ┌─────────────────┐        │                  │              │              │           │
│  │ GL-BE3600       │        │                  │              │              │           │
│  │ (Slate 7,       │        │                  │              │              │           │
│  │  travel/exit)   │        │                  │              │              │           │
│  └─────────────────┘        │                  │              │              │           │
│  ┌─────────────────┐        │                  │              │              │           │
│  │ GL-MT3000       │        │                  │              │              │           │
│  │ (Beryl AX,      │        │                  │              │              │           │
│  │  travel/exit)   │        │                  │              │              │           │
│  └─────────────────┘        │                  │              │              │           │
│  ┌─────────────────┐        │                  │              │              │           │
│  │ 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     ║
║  Beryl 7 = GL-MT3600BE (primary remote)  Slate 7 = GL-BE3600 (travel)                  ║
║  Beryl AX = GL-MT3000 (travel, repeater on Beryl 7)     ─ ─ = 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