# Unifi Network

## Access

- **Controller**: UDM Pro at 10.100.0.1 (Network Application v10.1.85)
- **API key**: oGFBSgxySOPPiwHj82F314h1T2RHY6OO
- **Site ID**: 88f7af54-98f8-306a-a1c7-c9349722b1f6 (Default)
- **API reference**: https://beez.ly/unifi-apis/network-10.1.85.json

### API Usage

```bash
# v1 integration API
curl -sk -H "X-API-KEY: oGFBSgxySOPPiwHj82F314h1T2RHY6OO" \
  'https://10.100.0.1/proxy/network/integration/v1/sites/88f7af54-98f8-306a-a1c7-c9349722b1f6/<endpoint>'

# Legacy stat API (more detailed port/device data)
curl -sk -H "X-API-KEY: oGFBSgxySOPPiwHj82F314h1T2RHY6OO" \
  'https://10.100.0.1/proxy/network/api/s/default/<endpoint>'
```

Key legacy endpoints: `stat/device` (full port tables), `rest/networkconf` (network/VLAN definitions).

## Networks / VLANs

| Name | VLAN ID | Subnet | Gateway | DHCP | Purpose |
|------|---------|--------|---------|------|---------|
| MGMT | untagged | 10.2.0.0/24 | 10.2.0.1 | Yes | Management (all Unifi devices) |
| LAN | 100 | 10.100.0.0/24 | 10.100.0.1 | Yes | Primary VM/client network |
| DATA | 50 | 10.50.0.0/24 | 10.50.0.1 | No | Storage / jumbo frame network |
| IOT | 200 | 10.200.0.0/24 | 10.200.0.1 | Yes | IoT devices |
| GUEST | 3 | 10.3.0.0/24 | 10.3.0.1 | Yes | Guest network |
| Inter-VLAN | 4040 | 10.255.253.0/24 | 10.255.253.1 | No | Inter-VLAN routing |

**Note**: DATA network is managed as a switch-only network on the USW Pro Aggregation (not routed through the UDM Pro gateway).

## Devices

### Switches

| Name | Model | IP | State | Firmware | Ports |
|------|-------|----|-------|----------|-------|
| UDM_Pro | UDM Pro | 67.144.61.115 (WAN) | ONLINE | 5.0.12 | 11 (GE + 2x SFP+) |
| USW Pro Aggregation | USW Pro Aggregation | 10.2.0.173 | ONLINE | 7.2.123 | 28x SFP+ + 4x SFP28 |
| USW Pro Max 16 PoE | USW Pro Max 16 PoE | 10.2.0.108 | ONLINE | 7.2.123 | 12x GE + 4x 2.5GE + 2x SFP+ |
| JoesDeskSwitch | USW Pro XG 8 PoE | 10.2.0.231 | ONLINE | 7.2.123 | 8x 10GE + 2x SFP+ |
| GarageSwitch | USW Flex 2.5G 8 PoE | 10.2.0.238 | ONLINE | 2.1.8 | 8x 2.5GE + 1x 10GE + 1x SFP+ |
| LightCtrlPanelSwitch | USW Flex 2.5G 8 | 10.2.0.63 | ONLINE | 2.1.8 | 8x 2.5GE + 1x 10GE + 1x SFP+ |
| FamilyRoomSwitch | USW Flex 2.5G 8 | 10.2.0.69 | **OFFLINE** | 2.1.8 | 8x 2.5GE + 1x 10GE + 1x SFP+ |

### Access Points

| Name | Model | IP | State |
|------|-------|----|-------|
| FamilyRoomAP | U7-Pro-Wall | 10.2.0.89 | ONLINE |
| LivRm-U7-Pro-Wall | U7-Pro-Wall | 10.2.0.109 | ONLINE |
| GarageAP | U7-Pro-Wall | 10.2.0.102 | ONLINE |
| JoesRm-U7-Pro-Wall | U7-Pro-Wall | 10.2.0.107 | **OFFLINE** |
| U7 Pro XGS | U7 Pro XGS | 10.2.0.170 | ONLINE |

## USW Pro Aggregation — Port Map

This is the central switch connecting the ESXi host, desktop, and other switches.

### Key Ports (ESXi + Desktop)

| Port | Speed | Connector | Native VLAN | Forward | Connected To | SFP |
|------|-------|-----------|-------------|---------|-------------|-----|
| **19** | 10 Gbps | SFP+ | LAN (100) | customize | Desktop LAN NIC (10.100.0.49) | SFP-10G-T |
| **20** | 10 Gbps | SFP+ | DATA (50) | customize | Desktop DATA NIC (10.50.0.49) | UF-RJ45-10G |
| **31** | 25 Gbps | SFP28 | MGMT (untagged) | all (trunk) | ESXi vmnic4 → vSwitch0 | DAC-SFP28-3M |
| **32** | 25 Gbps | SFP28 | MGMT (untagged) | all (trunk) | ESXi vmnic5 → jumboFrameSwitch | DAC-SFP28-3M |

- **Port 31** is a trunk carrying all VLANs (MGMT native + tagged LAN/100, IOT/200, GUEST/3, DATA/50) to ESXi vSwitch0
- **Port 32** is a trunk carrying all VLANs (MGMT native + tagged DATA/50, LAN/100, etc.) to the ESXi jumbo frame switch — changed from `customize/native=DATA` to `all` to fix VLAN 50 tag mismatch with ESXi
- **Port 19** carries LAN (VLAN 100) to the desktop
- **Port 20** carries DATA (VLAN 50) to the desktop

### Uplink / Infrastructure Ports

| Port | Speed | State | Connected To | SFP |
|------|-------|-------|-------------|-----|
| 28 | 10 Gbps | UP | UDM Pro (uplink) | DAC-SFP10-0.5M |
| 27 | 10 Gbps | UP | Downstream switch (55 MACs) | DAC-SFP10-0.5M |

### Other Active Ports

| Port | Speed | State | Native VLAN | MACs | SFP |
|------|-------|-------|-------------|------|-----|
| 1 | 1 Gbps | UP | — | 4 | SFP1G-SX-85 |
| 2 | 10 Gbps | UP | — | 9 | SFP-10G-LR |
| 3 | 1 Gbps | UP | MGMT | 19 | 10GBASE-SR |
| 6 | 10 Gbps | UP | MGMT | 1 | QT-BIDI-SFP+-LR |
| 8 | 10 Gbps | UP | — | 0 | QT-BIDI-SFP+-LR (LAG member) |
| 9 | 10 Gbps | UP | MGMT | 0 | SFP-H10GB-CU3M |
| 11 | 10 Gbps | UP | MGMT | 0 | SFP-H10GB-CU3M |

Ports 4-5, 7, 10, 12-18, 21-26, 29-30: down / unused.

## Network Config IDs

Reference for mapping legacy API `native_networkconf_id` values:

| ID | Network |
|----|---------|
| 6796b2c822a9fa6cefe4f113 | MGMT (untagged) |
| 6796b4d3b07ab40dd44e3136 | LAN (VLAN 100) |
| 699440642ebebe33f1163116 | DATA (VLAN 50) |
| 6796b58bb07ab40dd44e3151 | IOT (VLAN 200) |
| 6796b5aeb07ab40dd44e3158 | GUEST (VLAN 3) |
| 699440642ebebe33f1163119 | Inter-VLAN (4040) |