festion/omada-network-management
claude-resources/skills/omada-network-management/SKILL.md
TP-Link Omada SDN network management for the Lakehouse homelab. Use when managing switches, access points, VLANs, spanning tree, or WiFi infrastructure. Triggers on phrases like "adopt device", "configure VLAN", "switch CLI", "WiFi troubleshooting", "Omada API", "STP blocking", "PoE budget", or any network hardware management.
tools
Updated May 16, 2026
$ install --global
skillsauthnpx skillsauth add festion/homelab-gitops omada-network-managementInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 16, 2026, 3:10 AM198.4s8 files scanned
SKILL.md
- name:
- omada-network-management
- description:
- TP-Link Omada SDN network management for the Lakehouse homelab. Use when managing switches, access points, VLANs, spanning tree, or WiFi infrastructure. Triggers on phrases like "adopt device", "configure VLAN", "switch CLI", "WiFi troubleshooting", "Omada API", "STP blocking", "PoE budget", or any network hardware management.
TP-Link Omada Network Management Skill
Manage the Lakehouse TP-Link Omada SDN infrastructure including switches, access points, VLANs, and spanning tree configuration.
Infrastructure Overview
| Component | Model/Version | IP | Purpose | |-----------|---------------|-----|---------| | Controller | Omada SDN v6.1.0.19 | 192.168.1.47 | Central management | | Core Switch | SG3218XP-M2 | 192.168.1.210 | L2+ managed switch with PoE | | DownstairsAP | EAP773 (WiFi 7) | 192.168.1.242 | Primary AP, Port 8 | | UpstairsAP | EAP773 (WiFi 7) | 192.168.1.22 | Secondary AP, Port 3 | | Attic AP | EAP225 (WiFi 5) | 192.168.1.109 | Tertiary AP |
Controller Access
| Method | URL/Command | |--------|-------------| | Web UI (internal) | https://omada.internal.lakehouse.wtf | | Web UI (direct) | https://192.168.1.47:8043 | | SSH/Management | ssh [email protected] | | LXC ID | 111 (proxmox3) |
Quick Reference
Device Adoption
- Discovery: Ensure DHCP Option 138 points to 192.168.1.47 (configured in Kea)
- Identification: Devices → Pending → Batch Adopt
- Credentials: If "Managed by Others", use password from Settings → Site → Device Account
- Monitoring: Watch status cycle: Adopting → Provisioning → Connected
Common GUI Paths (v6+)
| Task | Navigation | |------|------------| | VLAN/LAN Management | Network Config → Network Settings → LAN | | Port Management | Devices → [Switch] → Manage Device → Ports | | Site Services (NTP/LED) | Settings → Site → Services | | Open API Setup | Global View → Settings → Platform Integration → Open API | | Backup/Restore | Settings → Maintenance → Backup & Restore |
Switch CLI Quick Commands
# Enter privileged mode
enable
# Show port status
show interface status
# Check STP status
show spanning-tree summary
# Check PoE usage (240W budget)
show power inline
# Full diagnostic dump
show tech-support
Console Connection
| Parameter | Value | |-----------|-------| | Baud Rate | 38400 | | Data bits | 8 | | Stop bits | 1 | | Parity | None |
Common Issues & Quick Fixes
| Issue | Quick Fix |
|-------|-----------|
| Device won't adopt | Check DHCP Option 138 points to 192.168.1.47 |
| STP blocking ports | Set affected ports as Admin Edge in port settings |
| Firewalla misidentified | Clients → Config → Client Type → Router/Gateway |
| SSH auth fails (PuTTY) | Enable "Keyboard-interactive" or use -o HostKeyAlgorithms=+ssh-rsa |
| EAP225 slow green flash | Lost controller contact, check network/DHCP |
| EAP225 default IP | 192.168.0.254 (if DHCP fails) |
References
Detailed documentation for specific tasks:
- references/controller-operations.md - Adoption, backup, GUI navigation
- references/switch-cli.md - SG3218XP-M2 CLI commands
- references/vlan-stp-config.md - VLAN and spanning tree configuration
- references/api-reference.md - Omada API operations
- references/troubleshooting.md - Common issues and resolutions
- references/hardware-specs.md - Device specifications
- references/lakehouse-instance.md - Site-specific configuration
Integration with Lakehouse Infrastructure
DHCP (Kea HA)
- Primary: 192.168.1.133 | Secondary: 192.168.1.134
- Option 138: 192.168.1.47 (Omada controller CAPWAP discovery)
- After reservation changes: Run
kea-config-syncon kea-dhcp-1
DNS (AdGuard HA)
- Authoritative: adguard-2 (192.168.1.224) - make changes here
- Changes sync every 5 minutes to adguard (192.168.1.253)
Reverse Proxy (Traefik)
- IP: 192.168.1.110
- Domain: *.internal.lakehouse.wtf
Management Zone
- Use
*.mgmt.lakehouse.wtffor direct access - Example:
ssh [email protected]
Related Skills
festion/lxc-service-deployment
devops
VerifiedTrustedCommunity
Standardized deployment procedure for services in LXC containers on the Proxmox HA cluster. Use when deploying a new service, creating LXC containers, configuring DHCP reservations (Kea), DNS rewrites (AdGuard), reverse proxy routes (Traefik), or integrating with monitoring (Uptime Kuma) and dashboard (Homepage). Triggers on phrases like "deploy a new service", "create container for", "set up DHCP", "add Traefik route", "configure DNS rewrite", or any homelab infrastructure deployment.
SKILL.mdUpdated Apr 20, 2026
festion/prusa-mini-revo
testing
VerifiedTrustedCommunity
Print settings and optimization for Prusa Mini+ with E3D Revo Micro hotend, bowden direct drive extruder, and ObXidian nozzles (0.25mm, 0.4mm, 0.6mm, 0.8mm). Use when the user asks about print settings, slicer profiles, troubleshooting prints, material temperatures, flow rates, nozzle selection, or optimizing prints for this specific printer configuration. Triggers on phrases like "print settings", "slicer profile", "layer height", "print speed", "temperature", "first layer", "stringing", "calibration", "which nozzle", or any 3D printing task mentioning Prusa Mini, Revo, or ObXidian.
SKILL.mdUpdated Apr 13, 2026
festion/model-catalog
data-ai
VerifiedTrustedCommunity
Use when working with 3D model files (STL), print tracking, slicer profiles, or managing the model-catalog homelab service at model-catalog.internal.lakehouse.wtf
SKILL.mdUpdated Apr 13, 2026
festion/mesh3d
tools
VerifiedTrustedCommunity
Create and edit 3D printable mesh files (STL, 3MF, OBJ) programmatically using Python trimesh + manifold3d. Use when the user asks to create 3D objects, modify existing STL/3MF files, add holes/features to meshes, combine or split meshes, repair meshes, convert between formats, analyze mesh geometry, or generate parametric parts for 3D printing. Triggers on "create STL", "make a 3D model", "edit mesh", "add hole", "modify STL", "3MF", "printable", "mesh repair", "boolean", "combine meshes", or any 3D modeling task that doesn't require a GUI CAD tool.
SKILL.mdUpdated Apr 13, 2026