Sanitized mirror from private repository - 2026-03-21 11:14:37 UTC
This commit is contained in:
Gitea Mirror Bot
240
docs/diagrams/location-overview.md
Normal file
240
docs/diagrams/location-overview.md
Normal file
@@ -0,0 +1,240 @@
|
||||
# 🗺️ 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
|
||||
Reference in New Issue
Block a user