HomeLab Network Control

Configuration and settings management for the FlexNetOS home-lab network control stack. This project provides a pure-Rust CLI (netctl) and supporting documentation to manage the network infrastructure.

• Omada SDN Controller — TP-Link router, switches, and access points
• TRENDnet TEG-7124WS — Web-managed switch with LAG support
• AT&T BGW320-505 — Fiber gateway / modem monitoring

network-control (netctl) owns the off-host network fabric — the physical/SDN infrastructure on the wire: the Omada controller, switches, access points, and the gateway (VLANs, SSIDs, VPN policies, port/LAG config) ported from each vendor's web UI into Rust.

It does not own a host's own OS network stack. That is lane's plane (per lane ADR-0003): a workstation's interfaces, addresses, routes, and the netplan/NetworkManager rendering on that box (e.g. the Cognitum Seed USB link-local address env-ctl depends on). The split is by layer, not by device:

Neither tool should reach into the other's layer. Coordinate via weave when a change spans both (e.g. a host route that depends on a new VLAN).

• Rust (stable toolchain; see rust-toolchain.toml)
• Pixi — recommended package manager for docs/legacy Python tasks
• Nushell — automation scripts in scripts/nu/

# Rust
https://rustup.rs

# Pixi
curl -fsSL https://pixi.sh/install.sh | bash

# Nushell
pixi global install nushell

# Build the Rust workspace
cargo build --workspace --locked

# Host networking snapshot
cargo run --bin netctl -- status

# Omada controller info
cargo run --bin netctl -- omada info --insecure

# AT&T modem WAN status
cargo run --bin netctl -- modem

Run pixi run docs-serve and open http://127.0.0.1:8000, or see docs/docs/ for the source.

netctl link …, netctl bond apply, and netctl switch lag are dry-run by default — add --apply to commit. Disruptive live ops also require --force. Use --json on any command for machine-readable output.

network-control/
├── crates/
│   ├── netengine/    # Core logic library
│   ├── netctl/       # CLI front-end
│   └── netctl-gui/   # Native GUI front-end
├── config/           # Legacy Python configuration
├── docs/             # MkDocs documentation
├── infrastructure/   # IaC (Terraform, Ansible, MCP)
└── scripts/          # Nushell / PowerShell automation

• Site Health Score: 100
• Managed Devices: 3 (1 Gateway, 2 APs)
• Clients: 15 (5 wired, 10 wireless)
• SSID: FlexNetOS

• Web UI: https://127.0.0.1:8043

Private - Internal Use Only