diff --git a/naming-convention-simple.md b/naming-convention-simple.md new file mode 100644 index 0000000..e954565 --- /dev/null +++ b/naming-convention-simple.md @@ -0,0 +1,65 @@ +# Host Naming Convention + +## Standard Format + +All hosts in the hobbs.farm infrastructure follow this naming convention: + +``` +[-] +``` + +## 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 `.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 `.hobbs.farm` +5. Document in this wiki +6. Add to Ansible inventory + +--- + +*Last updated: 2026-02-04*