# 🗺️ Geographic Location Overview

## Overview

The homelab infrastructure spans 4 physical locations plus cloud and mobile components, all connected via Tailscale mesh VPN.

---

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

    %% Tailscale connections
    CON <-->|"Tailscale<br/>Primary Hub"| SEA
    CON <-->|"Tailscale"| TUC
    CON <-->|"Tailscale"| HON
    CON <-->|"Tailscale"| MSI
    
    SEA <-->|"Tailscale"| TUC
    SEA <-->|"Tailscale"| HON
    TUC <-->|"Tailscale"| 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 • Tailscale Connected                    ║
╚══════════════════════════════════════════════════════════════════════════════════════════╝


                                    🇺🇸 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+)         │   │
                    │  │  • Calypso (DS723+)             │   │
                    │  │  • Guava (Physical Host)        │   │
                    │  │  • Desktop (Workstation)        │   │
                    │  │  • Proxmox (VMs)                │   │
                    │  │  • Anubis (Mac Mini - AI)       │   │
                    │  │  • RPi 5 Vish                   │   │
                    │  └─────────────────────────────────┘   │
                    │                                         │
                    │  ┌─────────────────────────────────┐   │
                    │  │  Backup Network (2G/500M)       │   │
                    │  │  • Concord NUC                  │   │
                    │  │  • RPi 5 Kevin                  │   │
                    │  └─────────────────────────────────┘   │
                    │                                         │
                    │  Services: 150+ containers              │
                    │  Storage:  152TB across 2 NAS           │
                    └────────────────────┬────────────────────┘
                                         │
                                         │ Tailscale (all locations mesh connected)
                    ┌────────────────────┼────────────────────┐
                    │                    │                    │
                    ▼                    ▼                    ▼
    
    🌵 TUCSON, AZ                                    🌺 HONOLULU, HI
    ┌─────────────────────┐                         ┌─────────────────────┐
    │  Remote Backup Site │                         │  Remote Access      │
    │  ═══════════════════│                         │  ═══════════════════│
    │                     │                         │                     │
    │  • Setillo NAS      │                         │  • GL.iNet MT3000   │
    │    (Off-site backup)│                         │    (Travel Router)  │
    │                     │                         │                     │
    │  Services:          │                         │  • Partner's PC     │
    │  • Prometheus       │                         │    (bluecrownpf)    │
    │  • SNMP Exporter    │                         │                     │
    │  • AdGuard Home     │                         │  Access to:         │
    │  • Syncthing        │                         │  • Plex streaming   │
    │                     │                         │  • Immich photos    │
    │  Purpose:           │                         │  • All services via │
    │  • 3-2-1 backup     │                         │    Tailscale        │
    │  • 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   │ 10+     │ 25Gbps       │ Main infrastructure            ║
║  Concord (Backup)│ Failover  │ 2       │ 2G/500M      │ Redundant connectivity         ║
║  Tucson          │ Remote    │ 1       │ TBD          │ Off-site backup                ║
║  Honolulu        │ Remote    │ 2       │ TBD          │ Partner access                 ║
║  Seattle (Cloud) │ Cloud     │ 1       │ Shared       │ External services              ║
║  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 | Services |
|--------|------|------------|----------|
| Atlantis | Synology DS1823xs+ | 10GbE | 55 services |
| Calypso | Synology DS723+ | 10GbE | 17 services |
| Guava | Physical Host | 10GbE | 6 services |
| Desktop | Workstation | 10GbE | - |
| Proxmox | VM Host | 1GbE | 3 VMs (56 services) |
| Anubis | Mac Mini (Ubuntu) | 1GbE | 8 services (AI) |
| RPi 5 Vish | Raspberry Pi | 1GbE | 2 services |

### 🏠 Concord, CA - Backup ISP
| Device | Type | Connection | Purpose |
|--------|------|------------|---------|
| Concord NUC | Intel NUC | 1GbE | 9 services, failover |
| RPi 5 Kevin | Raspberry Pi | 1GbE | Edge services |

### 🌵 Tucson, AZ
| Device | Type | Connection | Purpose |
|--------|------|------------|---------|
| Setillo | Synology NAS | 1GbE | 4 services, off-site backup |

### 🌺 Honolulu, HI
| Device | Type | Connection | Purpose |
|--------|------|------------|---------|
| GL.iNet MT3000 | Travel Router | WiFi/LAN | Subnet router for local devices |
| bluecrownpassionflower | Partner's PC | LAN | Remote access to homelab |

### 🌲 Seattle, WA (Cloud)
| Device | Type | Connection | Purpose |
|--------|------|------------|---------|
| Contabo VM | Cloud VPS | Internet | 1 service, external access |

### ✈️ Mobile
| Device | Type | Connection | Purpose |
|--------|------|------------|---------|
| MSI Laptop | Laptop | WiFi/LAN | 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