# 🗺️ 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)

```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) │   │
                     │  │  • GL-MT3000 (HA subnet 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          │ Off-site backup, Plex          ║
║  Honolulu        │ Remote    │ 2       │ ISP          │ Partner access                 ║
║  Seattle (Cloud) │ Cloud     │ 1       │ Unmetered    │ Fluxer, LLMs, exit node        ║
║  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; 51 services |
| Calypso | Synology DS723+ | 10GbE | Secondary NAS; Headscale, NPM, Authentik |
| Guava | TrueNAS Scale (Ryzen 5 8600G) | 10GbE | Storage server; 12+ services |
| Shinku-Ryuu | Desktop workstation (i7-14700K) | 10GbE | Primary workstation |
| PVE | Proxmox host | 1GbE | Hypervisor for Homelab VM |
| Homelab VM | Proxmox VM (Ubuntu) | 1GbE | Monitoring hub; 30 services |
| matrix-ubuntu | Atlantis VM (Ubuntu 24.04) | 1GbE | Mastodon, Matrix, Mattermost |
| GL-BE3600 | GL.iNet router | 1GbE | Exit node; subnet `192.168.8.0/24` |
| GL-MT3000 | GL.iNet router | 1GbE | HA subnet router; `192.168.12.0/24` |
| RPi 5 (Vish) | Raspberry Pi 5 16GB | 1GbE | Edge; Pi-5 node |
| Jellyfish | Raspberry Pi 5 4GB | Tailscale | NAS/media; PhotoPrism |
| Anubis | Mac Mini (Late 2014) | 1GbE | Legacy; offline/standby |

### 🏠 Concord, CA - Backup ISP (2Gbps/500Mbps)
| Device | Type | Connection | Purpose |
|--------|------|------------|---------|
| Concord NUC | Intel NUC6i3SYB | 1GbE | Home Assistant, AdGuard, exit node |
| RPi 5 (Kevin) | Raspberry Pi 5 8GB | 1GbE | Edge services |
| Home Assistant Green | HA Green | 1GbE | Smart home hub (via GL-MT3000 subnet) |

### 🌵 Tucson, AZ
| Device | Type | Connection | Purpose |
|--------|------|------------|---------|
| Setillo | Synology DS223j | 1GbE | Off-site backup, Plex, AdGuard |

### 🌺 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 (16 vCPU, ~64GB RAM) | Internet | Fluxer, Ollama, BookStack, exit node |

### ✈️ Mobile
| Device | Type | Connection | Purpose |
|--------|------|------------|---------|
| MSI Prestige 13 AI Plus | Laptop | WiFi/Headscale | Remote administration, development |

---

## 🔗 Related Diagrams
- [Network Topology](network-topology.md) - Detailed network layout
- [Tailscale Mesh](tailscale-mesh.md) - VPN connectivity
- [Storage Topology](storage-topology.md) - Backup locations
