Sanitized mirror from private repository - 2026-04-20 01:24:42 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) │ │
|
||||
│ │ • 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 |
|
||||
|
||||
---
|
||||
|
||||
## 🔗 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