Back to Skills

homelab-vlan-segmentation

Segmenting home networks into VLANs for IoT, guest, trusted, and server traffic using UniFi, pfSense/OPNsense, and MikroTik — including switch trunk config, firewall rules, and wireless SSID mapping.

232,942stars35,499forksUpdated 7/25/2026

Security Assessment

Safe(95/100)
Security Score95/100

About homelab-vlan-segmentation

This skill is a practical guide to segmenting a flat home network into isolated VLANs so that IoT devices, guests, trusted personal machines, and servers cannot freely reach one another. It frames network segmentation as one of the most impactful security upgrades for a home network, solving the problem where a compromised smart TV or camera on a flat subnet can reach a NAS, PCs, and everything else. The guidance is explicitly defensive: it notes that all firewall rules shown add isolation between segments rather than removing existing protections, and advises applying changes in a maintenance window with connectivity verification after each step.

It provides a reusable VLAN design template (trusted, IoT, servers, guest, and management VLANs with subnets and gateways), worked examples of SSID-to-VLAN mapping and switch trunk/access port behavior, and concrete configuration walkthroughs for three platforms: UniFi (networks, WiFi, and traffic rules), pfSense/OPNsense (VLAN interfaces, per-VLAN DHCP, and top-down firewall rules including RFC1918 blocks with DNS and Home Assistant exceptions), and MikroTik (bridge VLAN filtering, tagged trunk ports, and untagged access ports). It also covers troubleshooting inter-VLAN routing and firewall rule ordering.

The target users are homelab operators, self-hosters, and security-conscious home network owners, from beginners who need the concept explained to those configuring trunk ports and firewall rules. Use cases include first-time VLAN setup, isolating IoT devices, creating a guest network that cannot see home devices, and debugging inter-VLAN connectivity issues.

FAQ

Which networking platforms does this skill cover?

UniFi (Dream Machine, switches, and APs), pfSense/OPNsense, and MikroTik. Each has its own step-by-step configuration section for creating VLANs, DHCP, SSID mapping, and firewall rules.

Will applying these firewall rules break my existing network?

The skill states that every rule shown adds isolation between segments and does not remove existing protections. It still recommends applying changes in a maintenance window and verifying connectivity between segments after each step before continuing.

What VLAN layout does it recommend?

A template of five VLANs: trusted (PCs/phones), IoT (smart devices), servers (NAS/Pi/self-hosted), guest (visitor Wi-Fi), and management (network gear web UIs), each with its own subnet and gateway.

How do IoT devices still reach services like Pi-hole DNS or Home Assistant?

The skill shows targeted allow rules placed before the broad RFC1918 block — for example allowing IoT to reach the Pi-hole IP on port 53 and Home Assistant on its port — since firewall rules are processed top-to-bottom with first match winning.

Do I need managed hardware for this?

Yes. VLAN segmentation requires VLAN-aware equipment such as a managed switch and a router/firewall that supports VLAN interfaces and inter-VLAN firewall rules (UniFi, pfSense/OPNsense, or MikroTik as documented).

Install homelab-vlan-segmentation

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill