Network Controller Role

Network Controller Role #

Purpose #

The network controller role deploys centralized management software for switches and access points as Podman containers managed by systemd.


Controllers #

ControllerManaged Devices
TP-Link Omada SDNEAP650-Outdoor AP (adopted); the SG2218 switch is standalone until CHG-0009

Since CHG-0008 the controller runs on dv02nms001v01, and the Builder keeps a stopped cold spare for when that VM is down. The pre-VLAN substrate is built without it ( Management Plane β†’ Network management).


Deployment #

AttributeOmada
Container runtimePodman
Web UI port8043 (HTTPS)
DiscoveryL2 discovery
systemd unitomada-controller.service

Air-Gapped Installation #

Container images are fetched as tarballs from the local artifacts server:

  1. Artifacts role downloads image from upstream, saves as tarball
  2. Controller role fetches tarball from http://artifacts.<site>.deevnet.net/
  3. podman load imports the image
  4. podman create sets up the container
  5. systemd manages the lifecycle

Relationship to Other Roles #

RoleRelationship
artifactsProvides container image tarballs
baseSystem prerequisites

Details #

For full configuration details, managed devices, and API automation, see Network Controllers.

Page last modified: September 27, 2026