Files
homelab-optimized/docs/diagrams/location-overview.md
Gitea Mirror Bot 7544b9dd06
Some checks failed
Documentation / Build Docusaurus (push) Failing after 5m4s
Documentation / Deploy to GitHub Pages (push) Has been skipped
Sanitized mirror from private repository - 2026-04-19 09:54:54 UTC
2026-04-19 09:54:54 +00:00

15 KiB

🗺️ Geographic Location Overview

Overview

The homelab infrastructure spans 4 physical locations plus cloud and mobile components, all connected via Headscale (self-hosted Tailscale control server at headscale.vish.gg:8443 on Calypso).


🌎 Location Map (Mermaid)

graph TB
    subgraph USA["🇺🇸 United States"]
        subgraph West["West Coast"]
            SEA["🌲 Seattle, WA<br/>Cloud VPS"]
            CON["🏠 Concord, CA<br/>PRIMARY HQ<br/>25Gbps Fiber"]
        end
        
        subgraph Southwest["Southwest"]
            TUC["🌵 Tucson, AZ<br/>Remote NAS"]
        end
        
        subgraph Pacific["Pacific"]
            HON["🌺 Honolulu, HI<br/>Remote Access"]
        end
    end

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

    %% Headscale connections
    CON <-->|"Headscale<br/>Primary Hub"| SEA
    CON <-->|"Headscale"| TUC
    CON <-->|"Headscale"| HON
    CON <-->|"Headscale"| MSI
    
    SEA <-->|"Headscale"| TUC
    SEA <-->|"Headscale"| HON
    TUC <-->|"Headscale"| HON

    classDef primary fill:#e74c3c,stroke:#333,stroke-width:3px,color:#fff
    classDef secondary fill:#3498db,stroke:#333,stroke-width:2px,color:#fff
    classDef remote fill:#2ecc71,stroke:#333,stroke-width:2px,color:#fff
    classDef mobile fill:#9b59b6,stroke:#333,stroke-width:2px,color:#fff

    class CON primary
    class SEA secondary
    class TUC,HON remote
    class MSI mobile

📝 ASCII Location Map

╔══════════════════════════════════════════════════════════════════════════════════════════╗
║                        HOMELAB GEOGRAPHIC DISTRIBUTION                                    ║
║             4 Locations + Cloud + Mobile • Headscale Mesh (headscale.vish.gg)            ║
╚══════════════════════════════════════════════════════════════════════════════════════════╝


                                    🇺🇸 UNITED STATES
    ═══════════════════════════════════════════════════════════════════════════════════


                    🌲 SEATTLE, WA                    
                    ┌─────────────────┐               
                    │  Contabo VM     │               
                    │  Cloud VPS      │               
                    │  • External     │               
                    │    Access       │               
                    └────────┬────────┘               
                             │                        
                             │ Tailscale              
                             │                        
    ─────────────────────────┼─────────────────────────────────────────────────────────
                             │
                             │
                    🏠 CONCORD, CA ◄──────── PRIMARY HEADQUARTERS
                    ┌─────────────────────────────────────────┐
                    │  ★ PRIMARY LOCATION                     │
                    │  ══════════════════                     │
                    │                                         │
                    │  Internet: 25Gbps Sonic Fiber           │
                    │  Backup:   2Gbps/500Mbps                │
                    │                                         │
                     │  ┌─────────────────────────────────┐   │
                     │  │  Main Network (25Gbps)          │   │
                     │  │  • Atlantis (DS1823xs+) 10GbE   │   │
                     │  │  • Calypso (DS723+) 10GbE       │   │
                     │  │  • Guava (TrueNAS Scale) 10GbE  │   │
                     │  │  • Shinku-Ryuu (Desktop) 10GbE  │   │
                     │  │  • Proxmox + Homelab VM         │   │
                     │  │  • matrix-ubuntu (on Atlantis)  │   │
                     │  │  • GL-BE3600 (exit node router) │   │
                     │  │  • RPi 5 (Vish)                 │   │
                     │  └─────────────────────────────────┘   │
                    │                                         │
                    │  ┌─────────────────────────────────┐   │
                    │  │  Backup Network (2G/500M)       │   │
                    │  │  • Concord NUC                  │   │
                    │  │  • RPi 5 Kevin                  │   │
                    │  └─────────────────────────────────┘   │
                     │                                         │
                     │  Services: 150+ containers              │
                     │  Storage:  152TB across 3 NAS           │
                    └────────────────────┬────────────────────┘
                                         │
                                         │ Tailscale (all locations mesh connected)
                    ┌────────────────────┼────────────────────┐
                     │                    │                    │
                     ▼                    ▼                    ▼
    
    🌵 TUCSON, AZ (via Headscale)                    🌺 HONOLULU, HI (via Headscale)
    ┌─────────────────────┐                         ┌─────────────────────┐
    │  Remote Backup Site │                         │  Remote Access      │
    │  ═══════════════════│                         │  ═══════════════════│
    │                     │                         │                     │
    │  • Setillo DS223j   │                         │  • bluecrownpf      │
    │    (Off-site backup)│                         │    (Partner's PC)   │
    │                     │                         │  • mah-pc           │
    │  Services:          │                         │                     │
    │  • Plex Server      │                         │  Access to:         │
    │  • AdGuard Home     │                         │  • Plex streaming   │
    │  • HyperBackup      │                         │  • All services via │
    │                     │                         │    Headscale        │
    │  Purpose:           │                         │                     │
    │  • 3-2-1 backup     │                         │                     │
    │  • Geographic       │                         │                     │
    │    redundancy       │                         │                     │
    └─────────────────────┘                         └─────────────────────┘
    
    
    ─────────────────────────────────────────────────────────────────────────────────────
    
    
    ✈️ MOBILE (Anywhere)
    ┌─────────────────────┐
    │  MSI Laptop         │
    │  ═══════════════════│
    │                     │
    │  • Full Tailscale   │
    │    access           │
    │  • Development      │
    │  • Remote admin     │
    │  • OpenHands        │
    │                     │
    │  Can connect from:  │
    │  • Hotels           │
    │  • Airports         │
    │  • Coffee shops     │
    │  • Anywhere with    │
    │    internet         │
    └─────────────────────┘


╔════════════════════════════════════════════════════════════════════════════════════════╗
║  LOCATION SUMMARY                                                                       ║
╠════════════════════════════════════════════════════════════════════════════════════════╣
║                                                                                         ║
║  Location        │ Type      │ Devices │ Bandwidth    │ Primary Purpose                ║
║  ────────────────┼───────────┼─────────┼──────────────┼─────────────────────────────── ║
║  Concord (Main)  │ Primary   │ 12+     │ 25Gbps       │ Main infrastructure            ║
║  Concord (Backup)│ Failover  │ 3       │ 2G/500M      │ Redundant connectivity + HA    ║
║  Tucson          │ Remote    │ 1       │ ISP          │ Setillo off-site NAS backup    ║
║  Remote (Beryl 7)│ Remote    │ 2       │ ISP          │ jellyfish + HA via Beryl 7     ║
║  Seattle (Cloud) │ Cloud     │ 1       │ Unmetered    │ HolyClaude, Stoatchat, DERP    ║
║  Mobile          │ Travel    │ 1       │ Variable     │ Remote administration          ║
║                                                                                         ║
╠════════════════════════════════════════════════════════════════════════════════════════╣
║  DISTANCES FROM PRIMARY (Concord, CA)                                                   ║
║  ─────────────────────────────────────                                                  ║
║  • Seattle, WA:     ~680 miles  (~1,100 km)                                            ║
║  • Tucson, AZ:      ~650 miles  (~1,050 km)                                            ║
║  • Honolulu, HI:    ~2,400 miles (~3,860 km)                                           ║
║                                                                                         ║
║  Latency (typical Tailscale):                                                           ║
║  • Concord ↔ Seattle:   ~25ms                                                          ║
║  • Concord ↔ Tucson:    ~35ms                                                          ║
║  • Concord ↔ Honolulu:  ~70ms                                                          ║
╚════════════════════════════════════════════════════════════════════════════════════════╝

📊 Device Distribution by Location

🏠 Concord, CA - Primary (Main Network)

Device Type Connection Notes
Atlantis Synology DS1823xs+ 10GbE Primary NAS; 59 containers
Calypso Synology DS723+ 10GbE Secondary NAS; 61 containers (Headscale, Authentik, Gitea, Immich)
Guava TrueNAS Scale (Ryzen 5 8600G) 10GbE Storage server; 19 containers
Shinku-Ryuu Desktop workstation (i7-14700K) 10GbE Primary workstation
PVE Proxmox host 1GbE Hypervisor for Homelab VM
Homelab VM Proxmox VM (Ubuntu) 1GbE Monitoring, Dashboard, tools; 37 containers
matrix-ubuntu Atlantis VM (Ubuntu 24.04), 4 vCPU, 16GB RAM, 1TB disk 1GbE NPM, Matrix, Mastodon, LiveKit, CrowdSec
GL-BE3600 GL.iNet Slate 7 router Varies Travel router, exit node (intermittent — powered on when travelling)
RPi 5 (Vish) Raspberry Pi 5 16GB 1GbE Edge; 7 containers

🏠 Concord, CA - Backup ISP (2Gbps/500Mbps)

Device Type Connection Purpose
Concord NUC Intel NUC6i3SYB 1GbE Home Assistant, AdGuard, exit node; 22 containers
RPi 5 (Kevin) Raspberry Pi 5 8GB 1GbE Edge services
Home Assistant Green HA Green 1GbE Smart home hub (via GL-MT3600BE subnet, Beryl 7)

🌵 Tucson, AZ

Device Type Connection Purpose
Setillo Synology DS223j 1GbE Off-site backup, secondary AdGuard, node/SNMP exporters; 4 containers
GL-MT3600BE (Beryl 7) GL.iNet router Tailscale Primary gateway for remote subnet; exit node, 192.168.12.0/24
GL-MT3000 (Beryl AX) GL.iNet router Tailscale Travel router, wireless repeater on Beryl 7; LAN 192.168.99.0/24, exit node (no subnet adv.)
Jellyfish Remote workstation Tailscale Media/photo host; 2 containers (behind Beryl 7)
moon Sibling's PC (Debian) Tailscale Behind GL-MT3000 (192.168.99.223)

🌺 Honolulu, HI

Device Type Connection Purpose
bluecrownpassionflower Partner's PC Headscale Remote homelab access
mah-pc Partner's PC Headscale Remote homelab access

🌲 Seattle, WA (Cloud)

Device Type Connection Purpose
seattle (Contabo VPS) Cloud VPS (Ubuntu 24.04, ~62GB RAM) Internet HolyClaude (AI coding, :3059), Matrix LiveKit, DERP relay, Stoatchat, exit node; 20 containers

✈️ Mobile

Device Type Connection Purpose
MSI Prestige 13 AI Plus Laptop WiFi/Headscale Remote administration, development