Vish/homelab-optimized
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Sanitized mirror from private repository - 2026-03-07 08:33:21 UTC
Some checks failed
Documentation / Build Docusaurus (push) Failing after 9s
Details
Documentation / Deploy to GitHub Pages (push) Has been skipped
Details

Browse Source
This commit is contained in:
Gitea Mirror Bot
2026-03-07 08:33:21 +00:00
commit 5d4f7d9d45
1159 changed files with 297074 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

233
docs/diagrams/location-overview.md Normal file
View File

@@ -0,0 +1,233 @@
# 🗺️ 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