Add simple naming convention reference

2026-02-04 09:02:22 -06:00
parent ebdbb2c8b3
commit 543c282fd5
1 changed files with 65 additions and 0 deletions
@@ -0,0 +1,65 @@
+# Host Naming Convention
+
+## Standard Format
+
+All hosts in the hobbs.farm infrastructure follow this naming convention:
+
+```
+<purpose>[-<qualifier>]
+```
+
+## Naming Categories
+
+### Compute Hosts (Docker/VM)
+Named after characters/references with memorable, easy-to-type names.
+
+| Name | IP | Role | Specs |
+|------|-----|------|-------|
+| **hobbs** | 192.168.86.192 | Primary Docker Host | i7-7700T, 24GB RAM, 238GB NVMe |
+| **peggy** | 192.168.86.45 | Legacy Docker Host | i7-6700T, 8GB RAM, 916GB NVMe + 7.3TB HDD (failing) |
+| **bart** | 192.168.86.181 | Frigate NVR | i5-4570T, 16GB RAM |
+
+### Network/Infrastructure
+Named by function.
+
+| Name | IP | Role |
+|------|-----|------|
+| **firewalla** | 192.168.86.1 | Firewalla Gold Router/Firewall |
+| **nas** | 192.168.86.30 | Synology NAS (16TB) |
+
+### Windows Hosts
+Named after Star Wars characters.
+
+| Name | IP | Role |
+|------|-----|------|
+| **yoda** | 192.168.86.31 | Blue Iris NVR |
+
+## Rules
+
+1. **Lowercase only** - No capitals in hostnames
+2. **No special characters** - Letters and numbers only, hyphens for qualifiers
+3. **Short and memorable** - Max 10 characters preferred
+4. **DNS registered** - All hosts get `<name>.hobbs.farm` entries
+5. **Static IPs** - All infrastructure hosts use DHCP reservations or static IPs
+
+## IP Allocation
+
+| Range | Purpose |
+|-------|---------|
+| 192.168.86.1-49 | Infrastructure (routers, NAS, servers) |
+| 192.168.86.50-99 | Reserved |
+| 192.168.86.100-199 | DHCP clients |
+| 192.168.86.200-254 | IoT/Cameras (VLAN 200 preferred) |
+
+## Adding New Hosts
+
+1. Choose name following convention
+2. Assign static IP in appropriate range
+3. Create DHCP reservation in Firewalla
+4. Add DNS entry for `<name>.hobbs.farm`
+5. Document in this wiki
+6. Add to Ansible inventory
+
+---
+
+*Last updated: 2026-02-04*