Network Controllers

Network Controllers #

Purpose #

Network controllers provide centralized management for switches and access points. They enable VLAN configuration, firmware updates, and API-based automation across all managed network devices.

graph LR
    A[Bootstrap Node
hosts controller] <--> B[Network Controller
Omada/UniFi] <--> C[Switches & APs
managed devices]

Both controllers run on the bootstrap node as containerized services, providing management capability during initial network configuration.


Software Platforms #

Site: dvntm (mobile)

The Omada SDN Controller manages all TP-Link Omada devices in the mobile site, including the SG2218 switch and EAP650-Outdoor access point.

Software #

AttributeValue
SoftwareOmada SDN Controller
DeploymentPodman container on bootstrap node
Web UIPort 8043 (HTTPS)
DiscoveryL2 discovery or manual adoption

Managed Devices #

DeviceType
SG2218Access Switch
EAP650-OutdoorAccess Point

Capabilities #

FeatureDescription
VLAN ManagementCreate VLANs, assign ports, configure trunks
SSID ConfigurationCreate SSIDs, map to VLANs, set security
Firmware UpdatesCentralized firmware management
REST APIAutomation via deevnet.net Ansible collection
Zero-touch ProvisioningDevices auto-discover and adopt

Automation #

The Omada controller provides a REST API used by the deevnet.net Ansible collection:

ComponentModule/Role
Switch portsomada_switch_port
VLANsomada_vlan
SSIDsomada_ssid

Site: dvnt (home)

The UniFi Network Application manages all Ubiquiti UniFi devices in the home site, including the USW-24-G2 and US-8 switches, and both UAP-AC-M access points.

Software #

AttributeValue
SoftwareUniFi Network Application
DeploymentPodman container on bootstrap node
Web UIPort 8443 (HTTPS)
DiscoveryL2 discovery or manual adoption

Managed Devices #

DeviceTypeQuantity
USW-24-G2Access Switch (primary)1
US-8Access Switch (secondary)1
UAP-AC-MAccess Point2

Capabilities #

FeatureDescription
VLAN ManagementCreate networks, assign port profiles
SSID ConfigurationCreate WLANs, map to networks, set security
Firmware UpdatesCentralized firmware management
REST APIAutomation via UniFi API
Zero-touch ProvisioningDevices auto-discover and adopt

Automation #

The UniFi controller provides a REST API. Automation is currently manual but planned:

ComponentStatus
Switch portsManual (API available)
VLANs/NetworksManual (API available)
WLANsManual (API available)

Controller Comparison #

FeatureOmada SDN (dvntm)UniFi Network (dvnt)
Managed switchesSG2218USW-24-G2, US-8
Managed APsEAP650-OutdoorUAP-AC-M (x2)
Web UI port80438443
APIRESTREST
Ansible supportdeevnet.net collectionPlanned
Container runtimePodmanPodman
Page last modified: March 13, 2026