network/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Purpose

netfix is a diagnostic/debugging toolkit for troubleshooting network connectivity between VMs running on an ESXi hypervisor host and an external client, connected through Unifi network switches.

Environment Context

• Hypervisor: VMware ESXi
• Network infrastructure: Ubiquiti Unifi switches
• Debugging scope: VM-to-external-client connectivity issues across the ESXi virtual switch and physical Unifi switch layers

Components

• TrueNAS Server — NAS at 10.100.0.25 (management) / 10.50.0.x (storage), serves SMB and NFS
• ESXi Host — HP server at 10.2.0.12, ESXi 8.0.3, 8 VMs (7 powered on), access via govc only (not SSH). Read esxi.md for credentials and connection details.
• Docker Server — Debian 13 at 10.100.0.35, Docker host for 21 containers (arr stack, Traefik, Semaphore/Ansible). This is the local machine.
• Infisical — Secrets management at https://infisical.dohertylan.com, runs as a Docker stack on the docker host
• Plex Server — Debian 11 at 10.100.0.24, Plex Media Server 1.43, NFS media from TrueNAS
• Home Assistant — HAOS at 10.100.0.40, HA 2026.2.2, 2,411 entities, smart home automation. API access only (no SSH).
• Ignition Gateway — Debian 11 at 10.100.0.90, Ignition 8.3.3 (Maker), SCADA/IIoT platform with PostgreSQL 13
• Veeam Server — Windows Server 2025 at 10.100.0.30, Veeam B&R 12.3, backup server. Read veeam.md for credentials and connection details.
• Desktop — Windows PC, dual-homed on LAN_100 (10.100.0.49) and DATA_50 (10.50.0.49)
• Wonderware Dev VM — Windows 10 ESXi VM at 10.100.0.48, OpenSSH (passwordless)
• Unifi Network — UDM Pro gateway + USW Pro Aggregation central switch, API access via key