homelab-network-setup
affaan-m/everything-claude-code
Design scalable home and homelab networks with proper IP planning, DHCP, DNS, and device segmentation.
What is homelab-network-setup?
This skill guides you through planning a home or small-lab network that can grow without major rebuilds. It covers choosing gateways, switches, and access points; designing IP ranges and DHCP reservations; setting up DNS; and avoiding common mistakes like double NAT and dynamic addresses for services.
- Design network topology with separated device roles (gateway, switch, access points, servers, clients)
- Plan non-overlapping IP subnets and DHCP scopes with reserved ranges for infrastructure
- Configure DHCP reservations and DNS using home.arpa domain for stable service addresses
- Choose appropriate gateway hardware (ISP router, UniFi, OPNsense, pfSense, MikroTik, Linux) for your use case
- Prepare for future VLAN segmentation without immediate implementation
- Troubleshoot common issues like double NAT, unstable Wi-Fi, and changing server addresses
How to install homelab-network-setup
npx skills add https://github.com/affaan-m/everything-claude-code --skill homelab-network-setupHow to use homelab-network-setup
- 1.Choose a gateway device appropriate for your needs (ISP router, UniFi, OPNsense, pfSense, MikroTik, or Linux)
- 2.Select non-overlapping /24 IP ranges for each network segment (trusted, IoT, servers, guest, management)
- 3.Reserve gateway at .1 and infrastructure at .2-.49 on each subnet; set DHCP pool from .50-.240
- 4.Create DHCP reservations for all services (NAS, Pi-hole, Home Assistant, SSH hosts)
- 5.Configure DNS to use home.arpa domain for local names and point DHCP clients to your resolver
- 6.Wire access points with Ethernet backhaul instead of mesh when possible
- 7.Document port mappings, cable labels, and which devices/SSIDs map to each network
Use cases
- Planning a new home network or upgrading from ISP-router-only setup
- Designing a small homelab with NAS, Pi-hole, Home Assistant, and lab servers
- Preparing infrastructure for future VLANs and guest network isolation
- Stabilizing an existing network by adding DHCP reservations and local DNS
- Choosing and configuring gateway and switch hardware for a growing lab
- Home network administrators planning a new setup
- Homelab enthusiasts building multi-device networks
- People troubleshooting double NAT or unstable Wi-Fi issues
- Network operators preparing for future segmentation and VLANs
homelab-network-setup FAQ
Avoid 192.168.1.0/24 (conflicts with VPNs and hotels). Use non-overlapping /24 ranges like 192.168.10.0/24 for trusted, 192.168.20.0/24 for IoT, 192.168.30.0/24 for servers, 192.168.40.0/24 for guest, and 192.168.99.0/24 for management.
ISP routers work for basic internet only; UniFi gateways offer good UI and ecosystem; OPNsense/pfSense provide strong VLAN and firewall control; MikroTik is powerful but complex; Linux routers suit tinkerers. Choose based on your operator skill, not just features.
No. Use DHCP reservations for anything you SSH into, bookmark, monitor, or expose as a service (NAS, Pi-hole, Home Assistant). Keep dynamic DHCP for clients and IoT devices.
Use home.arpa, which is reserved for home networks and avoids conflicts. Examples: nas.home.arpa, pihole.home.arpa, gateway.home.arpa.
Ensure only one device (your gateway) performs NAT. Disable DHCP and NAT on secondary routers or access points. Document any intentional double NAT with a reason.
Full instructions (SKILL.md)
Source of truth, from affaan-m/everything-claude-code.
name: homelab-network-setup description: Practical home and homelab network planning for gateways, switches, access points, IP ranges, DHCP reservations, DNS, cabling, and common beginner mistakes. metadata: origin: community
Homelab Network Setup
Use this skill to design a home or small-lab network that can grow without needing a full rebuild.
When to Use
- Planning a new home network or redesigning an ISP-router-only setup.
- Choosing gateway, switch, and access point roles.
- Designing IP ranges, DHCP scopes, static reservations, and DNS.
- Preparing for future VLANs, Pi-hole, NAS, lab servers, or VPN access.
- Troubleshooting a new network that has double NAT, unstable Wi-Fi, or changing server addresses.
How It Works
Start by separating device roles:
Internet
|
Modem or ONT
|
Gateway or router NAT, firewall, DHCP, DNS, inter-VLAN routing
|
Managed switch wired clients, AP uplinks, optional VLAN trunks
|
Access points Wi-Fi only; ideally wired backhaul
Servers and NAS stable addresses, DNS names, monitoring
Clients and IoT DHCP pools, isolated later if VLANs are available
Pick a gateway that matches the operator, not just the feature checklist:
| Option | Best fit | Notes |
|---|---|---|
| ISP router | Basic internet only | Limited control and often poor VLAN support |
| UniFi gateway | Managed home network | Good UI, ecosystem lock-in |
| OPNsense or pfSense | Flexible homelab | Strong VLAN, firewall, VPN, and DNS control |
| MikroTik | Advanced network users | Powerful, but easy to misconfigure |
| Linux router | Tinkerers | Document rollback before using as primary gateway |
IP Plan
Avoid the most common default, 192.168.1.0/24, when you expect to use VPNs.
It often conflicts with hotels, offices, and ISP routers.
Example small homelab plan:
192.168.10.0/24 trusted clients
192.168.20.0/24 IoT and media devices
192.168.30.0/24 servers and NAS
192.168.40.0/24 guest Wi-Fi
192.168.99.0/24 network management
Gateway convention: .1
Infrastructure reservations: .2 through .49
Dynamic DHCP pool: .50 through .240
Spare room: .241 through .254
Use home.arpa for local names. It is reserved for home networks and avoids the
leakage/conflict problems of ad hoc names like home.lan.
nas.home.arpa
pihole.home.arpa
gateway.home.arpa
switch-01.home.arpa
DHCP And DNS
- Use DHCP reservations for anything you SSH into, bookmark, monitor, or expose as a service.
- Hand out the gateway as DNS until a local resolver is intentionally deployed.
- If using Pi-hole or another DNS filter, give it a reservation first, then point DHCP DNS options at that address.
- Keep a small static/reserved range per subnet so replacements do not collide with dynamic leases.
Cabling And Wi-Fi
- Prefer wired AP backhaul over mesh when you can run Ethernet.
- Use a PoE switch for APs and cameras if the budget allows it.
- Label both ends of each cable and keep a simple port map.
- Put the gateway, switch, DNS server, and NAS on UPS power if outages are common.
Examples
Beginner Upgrade
Goal: Keep the ISP router but stabilize a small lab.
- Set DHCP reservations for NAS, Pi, and any SSH hosts.
- Move local names to
home.arpa. - Disable duplicate DHCP servers on secondary routers or APs.
- Wire the main AP instead of relying on wireless backhaul.
VLAN-Ready Plan
Goal: Prepare for future segmentation without enabling it immediately.
- Choose non-overlapping /24 ranges for trusted, IoT, servers, guest, and management.
- Reserve .1 for the gateway and .2-.49 for infrastructure on every subnet.
- Buy a gateway and switch that support VLANs and inter-VLAN firewall rules.
- Document which SSIDs and switch ports will eventually map to each network.
Anti-Patterns
- Double NAT without a reason or documentation.
- Using
192.168.1.0/24when VPN access is planned. - Dynamic addresses for NAS, Pi-hole, Home Assistant, or other service hosts.
- Consumer routers repurposed as APs while their DHCP servers are still enabled.
- Flat networks with cameras, smart plugs, laptops, and servers all sharing the same trust boundary.
See Also
- Skill:
network-interface-health - Skill:
network-config-validation
Related skills
More from affaan-m/everything-claude-code and the wider catalog.

homelab-pihole-dns
Network-wide DNS ad blocker and local DNS management for home networks.

homelab-vlan-segmentation
Segment home networks into isolated VLANs for IoT, guest, and trusted traffic with UniFi, pfSense, OPNsense, or MikroTik.

homelab-wireguard-vpn
Fast, modern WireGuard VPN server setup for secure remote access to your home network.

hookify-rules
Create and manage Hookify rules to enforce patterns and guard against risky operations in Claude Code.

inventory-demand-planning
Demand forecasting, safety stock optimization, and replenishment planning for multi-location retailers.

investor-materials
Create consistent, credible investor materials—pitch decks, financial models, memos, and fundraising docs that align to a single source of truth.