nwa/nwa/html/md/docs.md

Software Defined Laboratory (SDL)

NOTE: This is a work in progress. SDL has only been tested on Debian based Linux systems. But has been designed to be cross platform. So running on other platforms should not be a heavy lift.

Other than basic OS tools, SDL downloads all dependencies idempotently and installs everything into a single SDL home directory (~/.sdl).

---

SDL Manager (sdl-mgr)

Installation

git clone <SDL_REPO_URL>

cd sdl

./install-sdl.sh

Upgrading

cd sdl

git pull origin main

./install-sdl.sh

---

SDL Worker (sdl-wkr)

Prerequisites

(Debian, Ubuntu, Linux Mint, Zorin OS, Raspbian)

sudo apt -y install gawk coreutils curl jq grep sed tar unzip netcat-openbsd

Installation

(Linux, OSX, Windows(WSL2))

Listen to UDP Broadcast on port 10101

• To get the sld-wkr curl or wget install command

nc -u -l -k 10101

OR

nc -u -l -k 10101 |jq
{
  "ts": "2026-01-31T05:20:31.815Z",
  "sdl_id": "906a027c-52f0-4cbb-b3e0-5eb84856d50a",
  "role": "sdl-mgr",
  "host": "haverlab-sld-mgr",
  "type": "udp-beacon",
  "msg": {
    "info": {
      "desc": "Software Defined Laboratory: Manager (sdl-mgr)",
      "version": "0.2.10",
      "copyright": "2026 John Haverlack"
    },
    "cluster": {
      "id": "haverlab",
      "name": "Haverlab",
      "desc": "John Haverlack's Home Lab"
    },
    "mqtt": {
      "host": "10.0.0.178",
      "port": 1883
    },
    "web": {
      "proto": "http",
      "host": "10.0.0.178",
      "port": 8081,
      "api_config": "/api/config",
      "config_url": "http://10.0.0.178:8081/api/config"
    },
    "sdl_wkr_install_cmd": {
      "curl": "curl -s http://10.0.0.178:8081/dist/install-sdl-wkr.sh | bash -s 10.0.0.178",
      "wget": "wget -O - http://10.0.0.178:8081/dist/install-sdl-wkr.sh | bash -s 10.0.0.178"
    }
  }
}

curl -s http://<SDL_MGR_IP>:<WEB_PORT>/dist/install-sdl-wkr.sh | bash -s <SDL_MGR_IP>

Upgrading

SDL Workers continuously monitor the SDL Manager’s advertised version via MQTT cluster status messages and will automatically re-install and restart when a newer version is detected.

Alternatively you can upgrade manually by rerunning the install-sdl-wkr.sh script.

curl -s http://<SDL_MGR_IP>:<WEB_PORT>/dist/install-sdl-wkr.sh | bash -s <SDL_MGR_IP>