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

Sanitized mirror from private repository - 2026-04-19 08:46:29 UTC
Some checks failed
Documentation / Build Docusaurus (push) Failing after 17m32s
Details
Documentation / Deploy to GitHub Pages (push) Has been skipped
Details

Browse Source
This commit is contained in:
Gitea Mirror Bot
2026-04-19 08:46:29 +00:00
commit 11d496f233
1439 changed files with 363180 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

274
docs/diagrams/network-topology.md Normal file
View File

@@ -0,0 +1,274 @@
# 🌐 Network Topology
## Overview
This document shows the physical and logical network layout across all homelab locations, connected via Tailscale VPN mesh.
---
## 🗺️ Geographic Overview (Mermaid)
```mermaid
graph TB
subgraph Internet["☁️ Internet"]
ISP1["Concord Primary<br/>25Gbps Fiber"]
ISP2["Concord Backup<br/>2G↓/500M↑"]
ISP3["Tucson ISP"]
ISP4["Honolulu ISP"]
CONTABO["Contabo Cloud<br/>Seattle"]
end
subgraph Concord_Primary["🏠 Concord, CA - Primary (25Gbps)"]
TPLINK["TP-Link Archer BE800<br/>Tri-Band Router"]
SWITCH["TP-Link TL-SX1008<br/>10GbE Switch"]
subgraph NAS_Cluster["📦 NAS Cluster"]
ATLANTIS["Atlantis<br/>DS1823xs+<br/>8x16TB"]
CALYPSO["Calypso<br/>DS723+<br/>2x12TB"]
end
subgraph Compute["💻 Compute"]
GUAVA["Guava<br/>TrueNAS Scale<br/>Ryzen 5 8600G"]
DESKTOP["Shinku-Ryuu<br/>i7-14700K + RTX 4080<br/>96GB DDR5"]
PROXMOX["Proxmox Host"]
OLARES["Olares<br/>Core Ultra 9 275HX<br/>RTX 5090, 96GB"]
end
subgraph Edge_Primary["📡 Edge Devices"]
PI_VISH["RPi 5<br/>(Vish)"]
GL_BERYL7["GL-MT3600BE (Beryl 7)<br/>remote router / exit<br/>192.168.12.0/24"]
GL_BE["GL-BE3600 (Slate 7)<br/>travel router / exit<br/>(exit-node only)"]
GL_MT3000["GL-MT3000 (Beryl AX)<br/>travel router / exit<br/>repeater on Beryl 7"]
end
subgraph VMs["🖥️ Virtual Machines"]
HOMELAB_VM["Homelab VM"]
MATRIX_VM["matrix-ubuntu<br/>(on Atlantis)"]
end
end
subgraph Concord_Backup["🏠 Concord, CA - Backup ISP (2G/500M)"]
NUC["Concord NUC<br/>Intel NUC"]
PI_KEVIN["RPi 5<br/>(Kevin)"]
end
subgraph Tucson["🌵 Tucson, AZ"]
SETILLO["Setillo<br/>DS223j<br/>2x10TB WD Gold"]
end
subgraph Honolulu["🌺 Honolulu, HI"]
BCPF["bluecrownpassionflower<br/>Sibling's PC"]
end
subgraph Mobile["✈️ Mobile/Travel"]
MSI["MSI Laptop<br/>Portable Workstation"]
end
subgraph Seattle["🌲 Seattle, WA (Cloud)"]
CONTABO_VM["Contabo VM<br/>Cloud VPS"]
end
%% Internet connections
ISP1 --> TPLINK
ISP2 --> NUC
ISP3 --> SETILLO
ISP4 --> BCPF
CONTABO --> CONTABO_VM
%% Concord Primary internal
TPLINK --> SWITCH
SWITCH -->|10GbE| ATLANTIS
SWITCH -->|10GbE| CALYPSO
SWITCH -->|10GbE| GUAVA
SWITCH -->|10GbE| DESKTOP
TPLINK -->|2.5GbE| PROXMOX
TPLINK -->|2.5GbE| OLARES
TPLINK -->|1GbE| PI_VISH
TPLINK -.->|Tailscale| GL_BERYL7
TPLINK -->|1GbE| GL_BE
PROXMOX --> HOMELAB_VM
ATLANTIS -->|VMM| MATRIX_VM
%% Tailscale/Headscale mesh (dashed)
ATLANTIS -.->|Headscale| SETILLO
ATLANTIS -.->|Headscale| NUC
ATLANTIS -.->|Headscale| BCPF
ATLANTIS -.->|Headscale| CONTABO_VM
ATLANTIS -.->|Headscale| MSI
classDef nas fill:#4a9eff,stroke:#333,stroke-width:2px,color:#fff
classDef compute fill:#9b59b6,stroke:#333,stroke-width:2px,color:#fff
classDef network fill:#2ecc71,stroke:#333,stroke-width:2px,color:#fff
classDef vm fill:#e74c3c,stroke:#333,stroke-width:2px,color:#fff
classDef cloud fill:#f39c12,stroke:#333,stroke-width:2px,color:#fff
classDef edge fill:#1abc9c,stroke:#333,stroke-width:2px,color:#fff
class ATLANTIS,CALYPSO,SETILLO nas
class GUAVA,DESKTOP,PROXMOX,OLARES compute
class TPLINK,SWITCH,GL_BERYL7,GL_BE network
class HOMELAB_VM,MATRIX_VM vm
class CONTABO_VM cloud
class NUC,PI_KEVIN,PI_VISH edge
```
---
## 📝 ASCII Network Topology
```
╔══════════════════════════════════════════════════════════════════════════════════════════╗
║ HOMELAB NETWORK TOPOLOGY ║
║ 4 Locations • Tailscale Mesh • 25Gbps Primary ║
╚══════════════════════════════════════════════════════════════════════════════════════════╝
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│ ☁️ INTERNET │
│ ═══════════════════════════════════════════════════════════════════════════════════════│
│ │
│ [Concord 25G] [Concord 2G/500M] [Tucson] [Honolulu] [Seattle] │
│ │ │ │ │ │ │
│ ▼ ▼ ▼ ▼ ▼ │
└─────────┼───────────────────┼──────────────────┼──────────────┼──────────────┼───────────┘
│ │ │ │ │
│ │ │ │ │
┌─────────▼───────────────────┼──────────────────┼──────────────┼──────────────┼───────────┐
│ 🏠 CONCORD, CA (PRIMARY) │ │ │ │ │
│ ════════════════════════ │ │ │ │ │
│ │ │ │ │ │
│ ┌──────────────────┐ │ │ │ │ │
│ │ TP-Link Archer BE800 │ │ │ │ │ │
│ │ (Tri-Band WiFi) │ │ │ │ │ │
│ └────────┬─────────┘ │ │ │ │ │
│ │ │ │ │ │ │
│ ▼ │ │ │ │ │
│ ┌──────────────────┐ │ │ │ │ │
│ │ TL-SX1008 10GbE │ │ │ │ │ │
│ │ 8-Port Switch │ │ │ │ │ │
│ └┬───┬───┬───┬─────┘ │ │ │ │ │
│ │ │ │ │ │ │ │ │ │
│ │ │ │ └─────────────┼──────────────────┼──────────────┼──────────────┼───────────┤
│ │ │ │ 10GbE │ │ │ │ │
│ ▼ ▼ ▼ ▼ │ │ │ │ │
│ ┌───┐┌───┐┌───┐┌───┐ │ │ │ │ │
│ │ATL││CAL││GUA││DSK│ │ │ │ │ │
│ │ ││ ││ ││ │ │ │ │ │ │
│ │8x ││2x ││ ││ │ │ │ │ │ │
│ │16T││12T││ ││ │ │ │ │ │ │
│ └───┘└───┘└───┘└───┘ │ │ │ │ │
│ │ │ │ │ │
│ ┌─────────────────┐ │ │ │ │ │
│ │ Proxmox Host │ │ │ │ │ │
│ │ ┌───────────┐ │ │ │ │ │ │
│ │ │ Homelab VM│ │ │ │ │ │ │
│ │ └───────────┘ │ │ │ │ │ │
│ └─────────────────┘ │ │ │ │ │
│ │ │ │ │ │
│ ┌─────────────────┐ │ │ │ │ │
│ │ GL-MT3600BE │ │ │ │ │ │
│ │ (Beryl 7, remote│ │ │ │ │ │
│ │ subnet router) │ │ │ │ │ │
│ └─────────────────┘ │ │ │ │ │
│ ┌─────────────────┐ │ │ │ │ │
│ │ GL-BE3600 │ │ │ │ │ │
│ │ (Slate 7, │ │ │ │ │ │
│ │ travel/exit) │ │ │ │ │ │
│ └─────────────────┘ │ │ │ │ │
│ ┌─────────────────┐ │ │ │ │ │
│ │ GL-MT3000 │ │ │ │ │ │
│ │ (Beryl AX, │ │ │ │ │ │
│ │ travel/exit) │ │ │ │ │ │
│ └─────────────────┘ │ │ │ │ │
│ ┌─────────────────┐ │ │ │ │ │
│ │ Olares │ │ │ │ │ │
│ │ (K8s, LLM) │ │ │ │ │ │
│ └─────────────────┘ │ │ │ │ │
│ ┌─────────────────┐ │ │ │ │ │
│ │ RPi 5 (Vish) │ │ │ │ │ │
│ │ (monitoring) │ │ │ │ │ │
│ └─────────────────┘ │ │ │ │ │
│ │ │ │ │ │
└─────────────────────────────┼──────────────────┼──────────────┼──────────────┼───────────┘
│ │ │ │
┌─────────────────────────────▼──────────────────┼──────────────┼──────────────┼───────────┐
│ 🏠 CONCORD BACKUP ISP │ │ │ │
│ ════════════════════════ │ │ │ │
│ ┌─────────┐ ┌─────────┐ │ │ │ │
│ │ Concord │ │ RPi 5 │ │ │ │ │
│ │ NUC │ │ (Kevin) │ │ │ │ │
│ └─────────┘ └─────────┘ │ │ │ │
└────────────────────────────────────────────────┼──────────────┼──────────────┼───────────┘
│ │ │
┌────────────────────────────────────────────────▼──────────────┼──────────────┼───────────┐
│ 🌵 TUCSON, AZ │ │ │
│ ════════════════ │ │ │
│ ┌─────────────┐ │ │ │
│ │ Setillo │◄─ ─ ─ ─ ─ ─ ─ ─ ─Tailscale─ ─ ─ ─ ─ ─ ─ ─ ─ ┤ │ │
│ │ Synology NAS│ │ │ │
│ └─────────────┘ │ │ │
└───────────────────────────────────────────────────────────────┼──────────────┼───────────┘
│ │
┌───────────────────────────────────────────────────────────────▼──────────────┼───────────┐
│ 🌺 HONOLULU, HI │ │
│ ════════════════ │ │
│ ┌──────────────────────┐ │ │
│ │ bluecrownpassionflower│◄─ ─ ─ ─Headscale─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┤ │
│ │ │ │ │
│ └──────────────────────┘ │ │
└──────────────────────────────────────────────────────────────────────────────┼───────────┘
│
┌──────────────────────────────────────────────────────────────────────────────▼───────────┐
│ 🌲 SEATTLE, WA (CLOUD) │
│ ══════════════════════ │
│ ┌─────────────┐ │
│ │ Contabo VM │◄─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─Tailscale─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┤
│ │ Cloud VPS │ │
│ └─────────────┘ │
└──────────────────────────────────────────────────────────────────────────────────────────┘
╔════════════════════════════════════════════════════════════════════════════════════════╗
║ LEGEND ║
║ ══════ ║
║ ATL = Atlantis (DS1823xs+) CAL = Calypso (DS723+) GUA = Guava (TrueNAS) ║
║ DSK = Shinku-Ryuu Desktop HLB = Homelab VM ─── = Physical Connection ║
║ Beryl 7 = GL-MT3600BE (primary remote) Slate 7 = GL-BE3600 (travel) ║
║ Beryl AX = GL-MT3000 (travel, repeater on Beryl 7) ─ ─ = Headscale VPN ║
║ ║
║ 10GbE connections: Atlantis, Calypso, Guava, Desktop ║
║ All other connections: 1GbE or WiFi ║
╚════════════════════════════════════════════════════════════════════════════════════════╝
```
---
## 📊 Connection Summary
### Concord Primary (25Gbps Fiber)
| Device | Connection | Speed | Purpose |
|--------|------------|-------|---------|
| Atlantis | TL-SX1008 | 10GbE | Primary NAS, media, services |
| Calypso | TL-SX1008 | 10GbE | Secondary NAS, development |
| Guava | TL-SX1008 | 10GbE | Physical compute host |
| Desktop | TL-SX1008 | 10GbE | Workstation |
| Proxmox | TP-Link Router | 2.5GbE | VM host |
| Olares | TP-Link Router | 2.5GbE | K8s, LLM inference |
| RPi 5 (Vish) | TP-Link Router | 1GbE | Monitoring, uptime |
### Concord Backup (2Gbps/500Mbps)
| Device | Connection | Speed | Purpose |
|--------|------------|-------|---------|
| Concord NUC | Direct | 1GbE | Edge computing, failover |
| RPi 5 (Kevin) | Direct | 1GbE | Lightweight services |
### Remote Locations
| Location | Device | Connection | Purpose |
|----------|--------|------------|---------|
| Tucson | Setillo (DS223j) | Headscale | Remote NAS, offsite backup |
| Honolulu | bluecrownpassionflower | Headscale | Sibling's PC |
| Seattle | Contabo VPS (seattle) | Headscale | Cloud services, exit node |
---
## 🔗 Related Diagrams
- [Tailscale Mesh](tailscale-mesh.md) - VPN overlay network details
- [10GbE Backbone](10gbe-backbone.md) - High-speed internal network
- [Location Overview](location-overview.md) - Geographic distribution