PluginBench
Skill
Pass
Audit score 90

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-setup
Claude Code
Cursor
Windsurf
Cline

How to use homelab-network-setup

  1. 1.Choose a gateway device appropriate for your needs (ISP router, UniFi, OPNsense, pfSense, MikroTik, or Linux)
  2. 2.Select non-overlapping /24 IP ranges for each network segment (trusted, IoT, servers, guest, management)
  3. 3.Reserve gateway at .1 and infrastructure at .2-.49 on each subnet; set DHCP pool from .50-.240
  4. 4.Create DHCP reservations for all services (NAS, Pi-hole, Home Assistant, SSH hosts)
  5. 5.Configure DNS to use home.arpa domain for local names and point DHCP clients to your resolver
  6. 6.Wire access points with Ethernet backhaul instead of mesh when possible
  7. 7.Document port mappings, cable labels, and which devices/SSIDs map to each network

Use cases

Good for
  • 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
Who it's for
  • 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

What IP range should I use for my homelab?

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.

Which gateway should I choose?

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.

Should I use DHCP for servers and services?

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.

What DNS domain should I use locally?

Use home.arpa, which is reserved for home networks and avoids conflicts. Examples: nas.home.arpa, pihole.home.arpa, gateway.home.arpa.

How do I avoid double NAT?

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:

OptionBest fitNotes
ISP routerBasic internet onlyLimited control and often poor VLAN support
UniFi gatewayManaged home networkGood UI, ecosystem lock-in
OPNsense or pfSenseFlexible homelabStrong VLAN, firewall, VPN, and DNS control
MikroTikAdvanced network usersPowerful, but easy to misconfigure
Linux routerTinkerersDocument 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.

  1. Set DHCP reservations for NAS, Pi, and any SSH hosts.
  2. Move local names to home.arpa.
  3. Disable duplicate DHCP servers on secondary routers or APs.
  4. Wire the main AP instead of relying on wireless backhaul.

VLAN-Ready Plan

Goal: Prepare for future segmentation without enabling it immediately.

  1. Choose non-overlapping /24 ranges for trusted, IoT, servers, guest, and management.
  2. Reserve .1 for the gateway and .2-.49 for infrastructure on every subnet.
  3. Buy a gateway and switch that support VLANs and inter-VLAN firewall rules.
  4. 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/24 when 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