# 🌐 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"]
            ANUBIS["Anubis<br/>Mac Mini (Ubuntu)<br/>AI/HPC"]
        end
        
        subgraph Edge_Primary["📡 Edge Devices"]
            PI_VISH["RPi 5<br/>(Vish)"]
        end
        
        subgraph VMs["🖥️ Virtual Machines"]
            HOMELAB_VM["Homelab VM"]
            CHICAGO_VM["Chicago VM"]
            BULGARIA_VM["Bulgaria VM"]
        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"]
        GLINET["GL.iNet MT3000<br/>Travel Router"]
        BCPF["bluecrownpassionflower<br/>Partner'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 --> GLINET
    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| ANUBIS
    TPLINK -->|1GbE| PI_VISH
    PROXMOX --> HOMELAB_VM
    PROXMOX --> CHICAGO_VM
    PROXMOX --> BULGARIA_VM

    %% Tailscale mesh (dashed)
    ATLANTIS -.->|Tailscale| SETILLO
    ATLANTIS -.->|Tailscale| NUC
    ATLANTIS -.->|Tailscale| GLINET
    ATLANTIS -.->|Tailscale| BCPF
    ATLANTIS -.->|Tailscale| CONTABO_VM
    ATLANTIS -.->|Tailscale| 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 compute
    class TPLINK,SWITCH,GLINET network
    class HOMELAB_VM,CHICAGO_VM,BULGARIA_VM vm
    class CONTABO_VM cloud
    class NUC,PI_KEVIN 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   │        │                  │              │              │           │
│  │  ┌───┬───┬───┐  │        │                  │              │              │           │
│  │  │HLB│CHI│BUL│  │        │                  │              │              │           │
│  │  │VM │VM │VM │  │        │                  │              │              │           │
│  │  └───┴───┴───┘  │        │                  │              │              │           │
│  └─────────────────┘        │                  │              │              │           │
│                             │                  │              │              │           │
└─────────────────────────────┼──────────────────┼──────────────┼──────────────┼───────────┘
                              │                  │              │              │
┌─────────────────────────────▼──────────────────┼──────────────┼──────────────┼───────────┐
│  🏠 CONCORD BACKUP ISP                         │              │              │           │
│  ════════════════════════                      │              │              │           │
│  ┌─────────┐  ┌─────────┐                      │              │              │           │
│  │ Concord │  │  RPi 5  │                      │              │              │           │
│  │   NUC   │  │ (Kevin) │                      │              │              │           │
│  └─────────┘  └─────────┘                      │              │              │           │
└────────────────────────────────────────────────┼──────────────┼──────────────┼───────────┘
                                                 │              │              │
┌────────────────────────────────────────────────▼──────────────┼──────────────┼───────────┐
│  🌵 TUCSON, AZ                                                │              │           │
│  ════════════════                                             │              │           │
│  ┌─────────────┐                                              │              │           │
│  │   Setillo   │◄─ ─ ─ ─ ─ ─ ─ ─ ─Tailscale─ ─ ─ ─ ─ ─ ─ ─ ─ ┤              │           │
│  │ Synology NAS│                                              │              │           │
│  └─────────────┘                                              │              │           │
└───────────────────────────────────────────────────────────────┼──────────────┼───────────┘
                                                                │              │
┌───────────────────────────────────────────────────────────────▼──────────────┼───────────┐
│  🌺 HONOLULU, HI                                                             │           │
│  ════════════════                                                            │           │
│  ┌─────────────┐  ┌──────────────────────┐                                   │           │
│  │ GL.iNet     │  │ bluecrownpassionflower│◄─ ─ ─ ─Tailscale─ ─ ─ ─ ─ ─ ─ ─ ┤           │
│  │ MT3000      │  │                      │                                   │           │
│  └─────────────┘  └──────────────────────┘                                   │           │
└──────────────────────────────────────────────────────────────────────────────┼───────────┘
                                                                               │
┌──────────────────────────────────────────────────────────────────────────────▼───────────┐
│  🌲 SEATTLE, WA (CLOUD)                                                                  │
│  ══════════════════════                                                                  │
│  ┌─────────────┐                                                                         │
│  │ Contabo VM  │◄─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─Tailscale─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┤
│  │ Cloud VPS   │                                                                         │
│  └─────────────┘                                                                         │
└──────────────────────────────────────────────────────────────────────────────────────────┘

╔════════════════════════════════════════════════════════════════════════════════════════╗
║  LEGEND                                                                                 ║
║  ══════                                                                                 ║
║  ATL = Atlantis (DS1823xs+)    CAL = Calypso (DS723+)    GUA = Guava                   ║
║  DSK = Desktop                  HLB = Homelab VM          CHI = Chicago VM              ║
║  BUL = Bulgaria VM              ─── = Physical Connection  ─ ─ = Tailscale 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 | 1GbE | VM host |

### 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 | Tailscale | Remote NAS, monitoring |
| Honolulu | GL.iNet MT3000 | Tailscale | Travel router, remote access |
| Honolulu | bluecrownpassionflower | Tailscale | TBD |
| Seattle | Contabo VM | Tailscale | Cloud services, external access |

---

## 🔗 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