Skip to content

Commit 62de8cf

Browse files
webosawebosa
committed
updates
1 parent cf781fc commit 62de8cf

6 files changed

Lines changed: 427 additions & 6 deletions

File tree

‎docs/home-lab/index.md‎

Lines changed: 39 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,41 @@
1-
# Network Topology
1+
---
2+
tags:
3+
- homelab
4+
- landing
5+
- manual
6+
---
27

3-
*Placeholder for Network documentation.*
8+
# Home Lab & Infrastructure
49

5-
## Overview
6-
- **Router**: (To be documented)
7-
- **Switches**: (To be documented)
8-
- **VLANs**: (To be documented)
10+
Welcome to the **EvisHomeLab** infrastructure documentation. This section covers the "Metal" and "Wire" layers that power the Smart Home.
11+
12+
<div class="grid cards" markdown>
13+
14+
- :material-lan: **[Network Topology](network_topology.md)**
15+
16+
Physical cabling maps, VLAN segmentation, and IP addressing schemes for the UniFi network.
17+
18+
- :material-server-network: **[Service Architecture](services.md)**
19+
20+
The software layer. Proxmox clusters, VM inventory, Docker stacks, and application catalogs.
21+
22+
- :material-server: **[Server Hardware](server_hardware.md)**
23+
24+
Specifications and component inventory for compute nodes (HALO, EDGE) and Raspberry Pis.
25+
26+
- :material-flash: **[Power Topology](power_topology.md)**
27+
28+
UPS battery backup systems, PDU layouts, and emergency shutdown procedures.
29+
30+
- :material-server-rack: **[Rack Elevation](rack_elevation.md)**
31+
32+
Physical layout of the server rack, detailing unit (U) positions and cabling.
33+
34+
</div>
35+
36+
## Quick Specs
37+
38+
* **Core Network:** 10Gbps SFP+ Backbone
39+
* **Hypervisor:** Proxmox VE (2-Node Cluster)
40+
* **Controller:** Home Assistant (VM)
41+
* **Storage:** *[TBD - e.g. TrueNAS / Synology]*

‎docs/home-lab/network_topology.md‎

Lines changed: 99 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,99 @@
1+
---
2+
tags:
3+
- homelab
4+
- network
5+
- manual
6+
---
7+
8+
# Network Topology
9+
10+
This page documents the physical and logical layout of the EvisHomeLab network.
11+
12+
## 1. Physical Topology
13+
14+
The core network is built on Ubiquiti UniFi gear, interconnected via 10Gbps SFP+ DACs and fiber where possible.
15+
16+
### Network Map
17+
18+
> [!INFO]
19+
> **Visualization:** This diagram represents the physical cabling hierarchy.
20+
21+
```mermaid
22+
graph TD
23+
%% Nodes
24+
ISP["ISP: DNA Oyj"]
25+
UDM["UDM Pro\nDream Machine Pro"]
26+
Agg["USW-Aggregation\n10G Core"]
27+
Ent["USW-Enterprise-24-PoE\nAccess Switch"]
28+
29+
%% Downstream Switches
30+
Lite8["USW-Lite-8-PoE\nLiving Room"]
31+
FlexBack["USW-Flex\nBackyard"]
32+
FlexFront["USW-Flex\nFront Porch"]
33+
FlexMini["USW-Flex-Mini\nOffice?"]
34+
35+
%% Access Points
36+
U7Pro["U7 Pro\nUpstairs"]
37+
U6Lite["U6-Lite\nBackyard"]
38+
39+
%% Key Clients
40+
Halo["Server | HALO\nProxmox Node"]
41+
Edge["Server | EDGE\nProxmox Node"]
42+
PiDNS1["RPi | DNS 63\nNTP/DNS"]
43+
PiDNS2["RPi | DNS 62\nNTP/DNS"]
44+
45+
%% Connections
46+
ISP -->|WAN| UDM
47+
UDM -->|10G SFP+| Agg
48+
49+
Agg -->|10G SFP+| Ent
50+
Agg -->|10G SFP+| Halo
51+
Agg -->|10G SFP+| Edge
52+
53+
Ent -->|Link| Lite8
54+
Ent -->|Link| FlexBack
55+
Ent -->|Link| FlexFront
56+
Ent -->|Link| FlexMini
57+
58+
%% Wireless Links
59+
Ent -->|PoE| U7Pro
60+
FlexBack -->|PoE| U6Lite
61+
```
62+
63+
### Device Hierachy
64+
65+
| Tier | Device | Role | Connection |
66+
| :--- | :--- | :--- | :--- |
67+
| **Core** | **UDM Pro** | Gateway / Router | WAN (ISP) |
68+
| **Core** | **USW-Aggregation** | Layer 2 Aggregation | 10G SFP+ to UDM |
69+
| **Access** | **USW-Enterprise-24-PoE** | Main Switch | 10G SFP+ to Agg |
70+
| **Edge** | **USW-Lite-8-PoE** | Living Room Media | Uplink to Ent |
71+
| **Edge** | **USW-Flex (Backyard)** | Outdoor PoE | Uplink to Ent |
72+
| **Edge** | **USW-Flex (Front Porch)** | Outdoor PoE | Uplink to Ent |
73+
| **Edge** | **USW-Flex-Mini** | Desktop/Misc | Uplink to Ent |
74+
75+
---
76+
77+
## 2. Logical Topology (VLANs)
78+
79+
*Defined network segments for isolation and security.*
80+
81+
| VLAN ID | Subnet | Name | Purpose |
82+
| :--- | :--- | :--- | :--- |
83+
| **1** | `10.0.1.0/24` | **Management** | Network Gear & Core Infra |
84+
| **TBD** | `TBD` | **IoT** | Untrusted Smart Devices |
85+
| **TBD** | `TBD` | **Servers** | Proxmox, NAS, Docker |
86+
| **TBD** | `TBD` | **Users** | Trusted Phones/Laptops |
87+
| **TBD** | `TBD` | **Guest** | Visitors (Client Isolation) |
88+
89+
> [!WARNING]
90+
> VLAN IDs and Subnets need to be verified against the UDM Pro configuration.
91+
92+
---
93+
94+
## 3. Addressing
95+
96+
### Key Gateways
97+
* **UDM Pro:** `10.0.1.1` (Default Gateway)
98+
* **DNS 1 (Pi-hole/AdGuard):** `10.0.x.63`
99+
* **DNS 2 (Pi-hole/AdGuard):** `10.0.x.62`

‎docs/home-lab/power_topology.md‎

Lines changed: 108 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,108 @@
1+
---
2+
tags:
3+
- homelab
4+
- power
5+
- manual
6+
---
7+
8+
# Power Topology
9+
10+
Documentation of the power distribution, battery backup tiers, and PoE trees.
11+
12+
## 1. Power Map
13+
14+
The lab uses a **Two-Tier UPS** strategy for the main rack, plus independent power for remote nodes.
15+
16+
```mermaid
17+
graph TD
18+
%% Nodes
19+
Grid[<b>Wall Outlet</b><br/>Grid Power]
20+
EcoFlow[<b>EcoFlow Delta 3</b><br/>Tier 1: Whole Rack Backup]
21+
PDU[<b>9-Outlet PDU</b><br/>Rack Distribution]
22+
APC[<b>APC 850 UPS</b><br/>Tier 2: Network Stack]
23+
24+
%% Compute Powers
25+
subgraph Compute [Compute Cluster (Tier 1 Power)]
26+
Reach[Server | <b>Reach</b>]
27+
Halo[Server | <b>Halo</b>]
28+
Edge[Server | <b>Edge</b>]
29+
end
30+
31+
%% Network Powers
32+
subgraph Network [Network Stack (Tier 1+2 Power)]
33+
UDM[UDM Pro]
34+
Agg[USW Aggregation]
35+
Ent[<b>USW Enterprise 24 PoE</b><br/>PoE Source]
36+
end
37+
38+
%% PoE Leaf Devices
39+
subgraph PoE_Leafs [PoE Powered Devices]
40+
RPiA[RPi 5 A]
41+
RPiB[RPi 5 B]
42+
U7[U7 Pro AP]
43+
FlexFront[<b>USW Flex</b><br/>Front Porch]
44+
end
45+
46+
%% Remote Power
47+
subgraph Remote [Remote Zones (Independent Power)]
48+
Injector[PoE Injector]
49+
Flex25[<b>USW Flex 2.5G</b><br/>Remote Room]
50+
FlexBack[<b>USW Flex</b><br/>Backyard]
51+
end
52+
53+
%% Connections
54+
Grid --> EcoFlow
55+
EcoFlow -->|AC| PDU
56+
57+
%% PDU Distribution
58+
PDU --> Reach
59+
PDU --> Halo
60+
PDU --> Edge
61+
PDU --> APC
62+
63+
%% APC Distribution
64+
APC --> UDM
65+
APC --> Agg
66+
APC --> Ent
67+
68+
%% PoE Tree
69+
Ent -.->|PoE| RPiA
70+
Ent -.->|PoE| RPiB
71+
Ent -.->|PoE+| U7
72+
Ent -.->|PoE++| FlexFront
73+
74+
%% Remote Logic
75+
Injector -->|PoE Power| Flex25
76+
Ent ===|Data Only| Flex25
77+
Flex25 -.->|PoE| FlexBack
78+
```
79+
80+
## 2. Backup Tiers
81+
82+
| Tier | Source | Runtime (Est) | Protected Scope |
83+
| :--- | :--- | :--- | :--- |
84+
| **Tier 1 (Base)** | **EcoFlow Delta 3** | *High Capacity* | **Entire Rack** (Compute + Network). Filters dirty power. |
85+
| **Tier 2 (Sensitive)** | **APC 850 UPS** | *Medium Capacity* | **Network Gear Only**. Provides double-conversion/clean power for UDM/Switches. |
86+
| **Edge** | **PoE Injector** | *0 mins* | Remote Switch (USW Flex 2.5G) - No backup currently. |
87+
88+
## 3. PDU Layout (Main Rack)
89+
90+
* **Source:** EcoFlow Delta 3 (AC Output)
91+
* **Distribution:**
92+
1. **APC 850 UPS** (Feeds Network)
93+
2. **Server | Halo**
94+
3. **Server | Edge**
95+
4. **Server | Reach**
96+
5. *(Empty)*
97+
6. *(Empty)*
98+
7. *(Empty)*
99+
8. *(Empty)*
100+
9. *(Empty)*
101+
102+
## 4. PoE Power Budget (USW Enterprise 24 PoE)
103+
104+
The Main Switch powers a significant tree of downstream devices.
105+
106+
* **Front Porch Chain:** Switch (PoE++) -> USW Flex -> Cameras (G4 Doorbell, G5 Turret).
107+
* **Internal Ops:** Raspberry Pi 5 A & B directly powered via PoE.
108+
* **Wireless:** U7 Pro AP (PoE+).

‎docs/home-lab/rack_elevation.md‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
tags:
3+
- homelab
4+
- rack
5+
- manual
6+
---
7+
8+
# Rack Elevation
9+
10+
Physical layout of the Server Rack.
11+
12+
**Total Height:** *[e.g. 24U, 42U]*
13+
14+
| Unit (U) | Device | Notes |
15+
| :--- | :--- | :--- |
16+
| **U24** | *Patch Panel?* | |
17+
| **U23** | **UDM Pro** | Dream Machine Pro |
18+
| **U22** | **USW-Aggregation** | 10G Aggregation Switch |
19+
| **U21** | **USW-Enterprise-24-PoE** | Main Switch |
20+
| **U20** | *Cable Management* | |
21+
| **U19** | **Server | HALO** | Proxmox Primary |
22+
| **U18** | **Server | HALO** | *(If 2U)* |
23+
| **U17** | **Server | REACH** | Proxmox Node |
24+
| **U16** | **Server | REACH** | *(If 2U)* |
25+
| **U15** | **Server | EDGE** | Proxmox Secondary |
26+
| **U14** | **Server | EDGE** | *(If 2U)* |
27+
| **...** | | |
28+
| **U05** | *Shelf* | Raspberry Pis, Hue Hub |
29+
| **U01** | **UPS** | Battery Backup |
30+
31+
> [!NOTE]
32+
> This table represents the physical vertical ordering of devices from Top (Highest U) to Bottom (U1).

‎docs/home-lab/server_hardware.md‎

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
---
2+
tags:
3+
- homelab
4+
- hardware
5+
- manual
6+
---
7+
8+
# Server Hardware
9+
10+
Inventory of the physical compute nodes in the Home Lab.
11+
12+
!!! info "Device Separation"
13+
This page tracks **Compute Hardware** (Servers, Pis). For Smart Home IoT devices (Sensors, Lights), see the [Device Inventory](../inventory/index.md).
14+
15+
## 1. Proxmox Nodes
16+
17+
The core compute cluster consists of two nodes: **HALO** (Primary) and **EDGE** (Secondary).
18+
19+
=== "Server | HALO"
20+
21+
**Role:** Primary Compute / Stable Workloads
22+
**OS:** Proxmox VE 8.x
23+
24+
| Component | Specification | Notes |
25+
| :--- | :--- | :--- |
26+
| **Chassis** | *TBD* | 2U/4U Rackmount? |
27+
| **CPU** | *TBD* | Intel/AMD ? |
28+
| **RAM** | *TBD* | DDR4/5 ECC? |
29+
| **Storage (Boot)** | *TBD* | NVMe/SSD? |
30+
| **Storage (Data)** | *TBD* | ZFS Pool? |
31+
| **Network** | 10GbE SFP+ | Connected to Aggregation Switch |
32+
33+
=== "Server | REACH"
34+
35+
**Role:** Compute / Expansion
36+
**OS:** Proxmox VE 8.x
37+
38+
| Component | Specification | Notes |
39+
| :--- | :--- | :--- |
40+
| **Chassis** | *TBD* | |
41+
| **CPU** | *TBD* | |
42+
| **RAM** | *TBD* | |
43+
| **Storage** | *TBD* | |
44+
| **Network** | *TBD* | |
45+
46+
=== "Server | EDGE"
47+
48+
**Role:** Secondary Compute / Docker Host / Testing
49+
**OS:** Proxmox VE 8.x
50+
51+
| Component | Specification | Notes |
52+
| :--- | :--- | :--- |
53+
| **Chassis** | *TBD* | |
54+
| **CPU** | *TBD* | |
55+
| **RAM** | *TBD* | |
56+
| **Storage** | *TBD* | |
57+
| **Network** | 10GbE SFP+ | Connected to Aggregation Switch |
58+
59+
---
60+
61+
## 2. Raspberry Pis
62+
63+
Low-power, independent nodes for critical infrastructure (DNS, NTP) that must survive a main server restart.
64+
65+
* **DNS 63:** Raspberry Pi 4 (Role: Primary DNS/NTP)
66+
* **DNS 62:** Raspberry Pi 4 (Role: Secondary DNS/NTP)
67+
* **RPi 5 A:** Raspberry Pi 5 (Role: *TBD*)
68+
* **RPi 5 B:** Raspberry Pi 5 (Role: *TBD*)
69+
70+
---
71+
72+
## 3. Storage Infrastructure (NAS)
73+
74+
*(Details about separate NAS hardware if applicable, or reference the Proxmox storage above)*

0 commit comments

Comments
 (0)