Files
homelab-optimized/docs/diagrams/location-overview.md
Gitea Mirror Bot 7398418236
Some checks failed
Documentation / Build Docusaurus (push) Failing after 1m49s
Documentation / Deploy to GitHub Pages (push) Has been skipped
Sanitized mirror from private repository - 2026-03-30 18:54:02 UTC
2026-03-30 18:54:02 +00:00

241 lines
15 KiB
Markdown

# 🗺️ 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, Authentik, Gitea, Immich |
| 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), 4 vCPU, 16GB RAM, 1TB disk | 1GbE | NPM, Mastodon, Matrix, Mattermost, CrowdSec |
| 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