Catalog
affaan-m/homelab-network-setup

affaan-m

homelab-network-setup

Practical home and homelab network planning for gateways, switches, access points, IP ranges, DHCP reservations, DNS, cabling, and common beginner mistakes. Use when planning or fixing a home or homelab network — gateway, switch, AP, IP ranges, DHCP, DNS, or cabling.

NewUpdated Sep 9, 2026

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.

  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
Files1
1 files · 1.0 KB

Select a file to preview

Overall Score

88/100

Grade

A

Excellent

Grades are signals, not a certification. Always review a skill yourself before use.

Safety

92

Quality

87

Clarity

89

Completeness

83

Summary

This skill provides practical guidance for designing and troubleshooting home and homelab networks, covering gateway selection, IP addressing schemes, DHCP/DNS configuration, and common pitfalls. It uses diagrams, tables, and concrete examples to help users plan scalable networks with growth potential and proper device segmentation without requiring invasive modifications to infrastructure.

Detected Capabilities

network planningdevice configuration guidanceIP addressing designDNS and DHCP setupgateway and switch role definitionwireless access point deploymenttroubleshooting guidance

Trigger Keywords

Phrases that agents use to match this skill to user intent.

home network planninghomelab setupgateway configurationIP addressing schemeDHCP reservationsnetwork troubleshootingdouble NAT issuesaccess point setupDNS configuration

Use Cases

  • Plan a new home network from scratch with proper gateway, switch, and AP roles
  • Design IP addressing and DHCP scopes that avoid conflicts and support future VLANs
  • Troubleshoot double NAT, Wi-Fi instability, and dynamic IP address issues in existing networks
  • Transition from ISP-router-only setup to a managed network with local DNS and DHCP reservations
  • Prepare infrastructure for future network segmentation without implementing VLANs immediately
  • Choose appropriate gateway hardware (ISP router vs. UniFi vs. OPNsense vs. MikroTik) based on network goals

Quality Notes

  • Well-structured skill with clear sections (When to Use, How It Works, IP Plan, DHCP and DNS, Cabling, Examples, Anti-Patterns)
  • Concrete examples include a small homelab IP allocation plan with specific subnet ranges, gateway conventions, and reservation blocks
  • Comparison table effectively distinguishes gateway options (ISP router, UniFi, OPNsense, pfSense, MikroTik, Linux) with honest fit assessments and limitations
  • Anti-Patterns section explicitly documents common mistakes (double NAT, default IP ranges, dynamic addresses for services), helping users avoid pitfalls
  • Uses visual text diagrams to illustrate network topology and IP allocation conventions
  • Practical guidance on naming conventions (home.arpa) and justifies choice to avoid leakage/conflict
  • Two worked examples (Beginner Upgrade, VLAN-Ready Plan) demonstrate different deployment paths and progression
  • Cabling and Wi-Fi recommendations address physical layer concerns (PoE, backhaul, UPS power)
  • References to related skills (network-interface-health, network-config-validation) establish ecosystem context
Model: claude-haiku-4-5-20251001Analyzed: Sep 9, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Version History

  1. v2.0

    Contract changed: description

    ✦ AIExpands activation description to clarify when agents should invoke the skill.

    triggering2026-09-09

    LATEST
  2. v1.1

    Content updated

    ✦ AINo behavioral changes detected in skill instructions or supporting files.

    2026-07-14

    View This Version
  3. v1.0

    2026-05-15

    View This VersionInitial version

Use affaan-m/homelab-network-setup in your dev environment

Command Palette

Search for a command to run...