# 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*