Empty initrd for display, add rp1_dsi module

ALL RP1 hardware (gpio, clocks, dsi) sits behind the RP1 PCIe
southbridge, which isn't ready until ~12s. Loading any display
module in initrd (~3s) crashes the system. Nothing in initrd now:
- boot.initrd.kernelModules: empty (nothing touches RP1 early)
- boot.kernelModules: vc4, panel_cwu50, rp1_dsi (stage-2)

.gitea/workflows/build-nixos.yml

@@ -1,64 +0,0 @@
-name: NixOS Build & Test
-run-name: Build ${{ gitea.event_name == 'push' && gitea.ref_name || format('PR #{0}', gitea.event.pull_request.number) }}
-
-on:
-  push:
-    branches:
-      - master
-    paths:
-      - '**.nix'
-      - 'flake.lock'
-      - 'secrets/**'
-      - 'hosts/**'
-      - 'modules/**'
-  pull_request:
-    branches:
-      - master
-    paths:
-      - '**.nix'
-      - 'flake.lock'
-      - 'secrets/**'
-      - 'hosts/**'
-      - 'modules/**'
-
-jobs:
-  build:
-    runs-on: nixos-builder
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Set up Nix environment
-        run: |
-          echo "extra-experimental-features = nix-command flakes" >> ~/.config/nix/nix.conf
-          cat ~/.config/nix/nix.conf
-
-      - name: Install nh (nix helper)
-        run: |
-          nix --extra-experimental-features "nix-command flakes" \
-            profile add nixpkgs#nh
-          nh --version
-
-      - name: Build NixOS configuration (lazyworkhorse)
-        run: |
-          nh os build .#lazyworkhorse
-        env:
-          NIX_CONFIG: "extra-experimental-features = nix-command flakes"
-
-      - name: Build NixOS configuration (cyt-pi)
-        run: |
-          nh os build .#cyt-pi
-        env:
-          NIX_CONFIG: "extra-experimental-features = nix-command flakes"
-
-      - name: Integration tests (placeholder)
-        run: |
-          echo "TODO: Add integration tests here"
-          echo ""
-          echo "Suggested future checks:"
-          echo "  - nix flake check  (evaluate all NixOS configs)"
-          echo "  - Validate agenix secrets are decryptable"
-          echo "  - Check services are defined correctly"
-          echo "  - Run VM test if nixos-test infrastructure exists"

flake.nix

@@ -2,20 +2,34 @@
   description = "Gortium infra flake";
 
   inputs = {
-    nixpkgs.url = "github:nixos/nixpkgs?ref=nixos-unstable";
+    nixpkgs.url = "github:nixos/nixpkgs?ref=25.11";
     agenix = {
       url = "github:ryantm/agenix";
       inputs.darwin.follows = "";
       inputs.nixpkgs.follows = "nixpkgs";
     };
+    disko = {
+      url = "github:nix-community/disko";
+      inputs.nixpkgs.follows = "nixpkgs";
+    };
     lix = {
       url = "git+https://git.lix.systems/lix-project/lix?ref=main";
       inputs.nixpkgs.follows = "nixpkgs";
     };
-    self.submodules = true;
+    nixpkgs-uconsole = {
+      url = "github:nixos/nixpkgs/54170c54449ea4d6725efd30d719c5e505f1c10e";
+    };
+    nixos-uconsole = {
+      url = "github:nixos-uconsole/nixos-uconsole/v1.1.0";
+      inputs.nixpkgs.follows = "nixpkgs-uconsole";
+    };
+    nixos-raspberrypi = {
+      url = "github:nvmd/nixos-raspberrypi/v1.20260317.0";
+      inputs.nixpkgs.follows = "nixos-uconsole/nixpkgs";
+    };
   };
 
-  outputs = { self, nixpkgs, agenix, lix, ... }@inputs:
+  outputs = { self, nixpkgs, agenix, disko, lix, nixos-uconsole, nixos-raspberrypi, ... }@inputs:
     let
       system = "x86_64-linux";
       keys = import ./lib/keys.nix;
@@ -26,7 +40,7 @@
           "/etc/ssh/ssh_host_ed25519_key"
           "/root/.age/bootstrap.key" ];
       };
-      overlays = [ agenix.overlays.default ];
+      overlays = [ agenix.overlays.default (import ./overlays/reticulum.nix) ];
       pkgs = import nixpkgs {
         inherit system overlays;
         config.allowUnfree = true;
@@ -59,7 +73,6 @@
               ./modules/nixos/filesystem/hoardingcow-mount.nix
               ./modules/nixos/services/docker_manager.nix
               ./modules/nixos/services/open_code_server.nix
-              ./modules/nixos/services/staging-vm.nix
               ./modules/nixos/services/ollama_init_custom_models.nix
               ./modules/nixos/services/openclaw_node.nix
               ./modules/nixos/security/ai-worker-restricted.nix
@@ -81,6 +94,24 @@
               ./hosts/cyt-pi/hardware-configuration.nix
             ];
           };
+
+          uConsole = nixos-uconsole.lib.mkUConsoleSystem {
+            variant = "cm5";
+            specialArgs = { inherit self keys paths inputs nixos-raspberrypi; };
+            modules = [
+              {
+                nixpkgs.overlays = overlays;
+                nixpkgs.config.allowUnfree = true;
+                nixpkgs.config.permittedInsecurePackages = [
+                  "openclaw-2026.3.12"
+                ];
+              }
+              disko.nixosModules.disko
+              ./hosts/uConsole/configuration.nix
+              ./hosts/uConsole/hardware-configuration.nix
+              ./hosts/uConsole/disko-config.nix
+            ];
+          };
         };
         devShells.${system}.default = devShell;
       };

hosts/lazyworkhorse/configuration.nix

@@ -11,6 +11,10 @@
   # Flakesss
   nix.settings.experimental-features = [ "nix-command" "flakes" "flake-self-attrs" ];
   nix.settings.trusted-users = [ "root" "gortium" ];
+  nix.settings.extra-platforms = [ "aarch64-linux" ];
+
+  # QEMU binfmt for cross-building aarch64 NixOS targets
+  boot.binfmt.emulatedSystems = [ "aarch64-linux" ];
 
   # Garbage collection
   nix.gc = {

hosts/uConsole/configuration.nix

@@ -0,0 +1,286 @@
+{ config, lib, pkgs, paths, self, keys, ... }:
+
+let
+  # Backlight fallback for CM5 display quirk
+  # The kernel driver usually handles this, but some boots need a kick
+  backlightFixScript = pkgs.writeShellScript "backlight-fix" ''
+    # Try sysfs backlight control
+    for bl in /sys/class/backlight/*/brightness; do
+      if [ -f "$bl" ]; then
+        max=$(cat "$(dirname "$bl")/max_brightness" 2>/dev/null || echo 100)
+        echo "$max" > "$bl" 2>/dev/null || true
+      fi
+    done
+  '';
+in
+
+{
+  # Basic Host Info
+  networking.hostName = "uConsole";
+  time.timeZone = "America/Montreal";
+  i18n.defaultLocale = "en_CA.UTF-8";
+
+  # System State
+  system.stateVersion = "25.11";
+
+  # Boot & Hardware (migrated to kernel bootloader per nixos-raspberrypi deprecation notice)
+  boot.loader.raspberry-pi.bootloader = "kernel";
+  # kernel managed by nixos-raspberrypi module — don't override, patches are version-specific
+  # boot.kernelPackages = pkgs.linuxPackages_latest;
+
+  # Kernel parameters matching nixos-uconsole CM5 module
+  # console=tty1 is critical — without it, console output goes to ttyAMA0 not fb0
+  boot.kernelParams = [
+    "8250.nr_uarts=1"
+    "console=tty1"
+  ];
+
+  # Enable Mesa GPU drivers — REQUIRED for VC4 display pipeline to initialize
+  hardware.graphics.enable = true;
+
+  # Console font sized for the 5" 720x1280 display (from nixos-uconsole base module)
+  console = {
+    earlySetup = true;
+    font = "ter-v24n";
+    packages = with pkgs; [ terminus_font ];
+  };
+
+  # Networking
+  networking.networkmanager.enable = true;
+  services.openssh = {
+    enable = true;
+    # TODO: lock down after first deployment
+    settings.PermitRootLogin = lib.mkForce "yes";
+    settings.PasswordAuthentication = lib.mkForce true;
+  };
+
+  # User
+  users.users.gortium = {
+    isNormalUser = true;
+    extraGroups = [ "wheel" "networkmanager" "video" "dialout" "kismet" ];
+    openssh.authorizedKeys.keys = [
+      keys.users.gortium.main
+      keys.users.gortium.gitea
+    ];
+  };
+  security.sudo.extraRules = [
+    {
+      users = [ "gortium" ];
+      commands = [
+        {
+          command = "ALL";
+          options = [ "NOPASSWD" ];
+        }
+      ];
+    }
+  ];
+
+  # ============================================================
+  # Package groups
+  # ============================================================
+
+  environment.systemPackages = with pkgs; [
+    # ===== Base =====
+    emacs-pgtk
+    git
+    ripgrep
+    fd
+    htop
+    tmux
+    neovim
+    libgpiod                    # GPIO control (for internal USB hub, AIO modules)
+
+    # ===== HAM Radio =====
+    js8call
+    wsjtx
+    fldigi
+    pat                        # Winlink client
+    direwolf                   # AX.25 packet modem
+    chirp                      # Radio programming tool
+    hamlib                     # Ham radio control libraries
+    trustedqsl                 # Logbook of the World (LoTW)
+
+    # ===== SDR / RF =====
+    sdrpp                      # SDR++ spectrum analyzer
+    gqrx                       # SDR receiver GUI
+    rtl-sdr                    # RTL-SDR drivers & utilities
+    inspectrum                # Offline signal analysis
+    soapysdr-with-plugins      # SoapySDR + hardware support plugins
+
+    # ===== Mesh / LoRa =====
+    # meshtastic not available in nixpkgs 25.11 stable; install manually:
+    # nix shell nixpkgs#meshtastic -c meshtastic
+    reticulumStack             # Reticulum Network Stack (rnsd, rnsh, rncp, rnx, rnpath, etc.)
+    lxmf                       # LXMF messaging protocol
+    nomadnet                   # Nomad Network client
+
+    # ===== Security =====
+    nmap
+    aircrack-ng
+    kismet                     # Wi-Fi monitor / IDS
+    bettercap                  # MITM/network attack framework
+    wireshark                  # Packet analyzer
+    hashcat                    # GPU password cracker
+    john                       # John the Ripper
+    sqlmap                     # SQL injection tool
+
+    # ===== GPS / Maps =====
+    foxtrotgps
+    viking                     # GPS map editor
+    gpsbabel                   # GPS data conversion
+  ];
+
+  # Packages noted but not in unstable nixpkgs:
+  #   - metasploit: unfree; install manually via Git clone
+  #   - burpsuite: unfree Java app (Community Edition available for download)
+  #   - sidechannel: not a distinct PyPI package; functionality covered by
+  #     the Reticulum stack. For LXMF GUI client, install Sideband manually
+  #     from github.com/markqvist/Sideband
+
+  # ============================================================
+  # Reticulum Service (rnsd)
+  # ============================================================
+  systemd.services.rnsd = {
+    description = "Reticulum Network Stack Daemon";
+    wants = [ "network-online.target" ];
+    after = [ "network-online.target" ];
+    wantedBy = [ "multi-user.target" ];
+    serviceConfig = {
+      User = "gortium";
+      Group = "gortium";
+      ExecStart = "${pkgs.reticulumStack}/bin/rnsd";
+      Restart = "always";
+      RestartSec = "10s";
+      LimitNOFILE = 65536;
+    };
+  };
+
+  # ============================================================
+  # Kismet Service (Wi-Fi monitoring / mesh node)
+  # ============================================================
+  systemd.services.kismet = {
+    description = "Kismet Wi-Fi Monitor & IDS";
+    wants = [ "network-online.target" ];
+    after = [ "network-online.target" ];
+    wantedBy = [ "multi-user.target" ];
+    serviceConfig = {
+      User = "gortium";
+      Group = "kismet";
+      ExecStart = "${pkgs.kismet}/bin/kismet -c wlan0 --log-base=/home/gortium/kismet_logs --no-nc-ui";
+      Restart = "always";
+      RestartSec = "10s";
+    };
+  };
+
+  # ============================================================
+  # Kernel modules for SDR, radio, and WiFi
+  # ============================================================
+  boot.kernelModules = [
+    "mt7921u"         # MediaTek MT7921 USB WiFi (uConsole AC1200)
+    "88x2bu"          # Realtek 8812/8821BU USB WiFi (common adapter)
+    "rtl8xxxu"        # RTL8188/8192/8723 USB WiFi
+    "rtl2832_sdr"     # RTL-SDR kernel module
+    "dvb_usb_rtl28xxu" # RTL-SDR DVB-T
+    # Display drivers — loaded AFTER RP1 PCIe southbridge init (~12s)
+    # NOTHING in initrd — ALL RP1 hardware is behind PCIe
+    "panel_cwu50"     # uConsole DSI panel driver
+    "vc4"             # VideoCore 4 KMS GPU driver
+    "rp1_dsi"         # RP1 DSI bridge driver
+  ];
+
+  boot.blacklistedKernelModules = [ ];
+
+  # Rien dans initrd pour le display — tout RP1 est derrière PCIe
+  boot.initrd.kernelModules = lib.mkForce [ ];
+
+  # ============================================================
+  # Extra udev rules for SDR and HAM radio devices
+  # ============================================================
+  services.udev.packages = with pkgs; [ rtl-sdr ];
+
+
+
+  # ============================================================
+  # Enable IPv6 for Reticulum mesh
+  # ============================================================
+  networking.enableIPv6 = true;
+
+  # ============================================================
+  # Firewall: open ports for Reticulum (optional)
+  # ============================================================
+  networking.firewall.allowedTCPPorts = [ 22 ]; # SSH only
+  networking.firewall.allowedUDPPorts = [ ];
+  # Reticulum uses its own encryption and doesn't need open ports
+  # for basic mesh operations (peer-to-peer discovery).
+  # For TCP interfaces, open additional ports as needed.
+
+  # ============================================================
+  # Hyprland Wayland compositor (manual start)
+  # No SDDM — boot to console, user starts Hyprland with command
+  # Display modules (vc4/panel_cwu50) load late after RP1 PCIe init
+  # ============================================================
+  programs.hyprland = {
+    enable = true;
+    xwayland.enable = true;
+  };
+  # SDDM disabled — was blocking boot when display isn't ready
+  # services.displayManager.sddm = {
+  #   enable = true;
+  #   wayland.enable = true;
+  # };
+
+  # ============================================================
+  # CM5 Config.txt Fix: use [pi5] section (not [cm5])
+  # Rex's images use [pi5], the CM5 firmware may not detect [cm5]
+  # ============================================================
+  # Merge nixos-uconsole GPIO config with our [pi5] overrides
+  # GPIO 10/11 are from nixos-uconsole configtxt.nix (audio amplifier)
+  # [pi5] section fixes the CM5 detection issue — firmware matches [pi5] not [cm5]
+  hardware.raspberry-pi.extra-config = ''
+    [all]
+    gpio=10=ip,np
+    gpio=11=op,dh
+
+    [pi5]
+    dtparam=pciex1=off
+    dtoverlay=clockworkpi-uconsole-cm5
+    dtoverlay=dwc2,dr_mode=host
+    dtoverlay=vc4-kms-v3d-pi5,cma-384
+    dtparam=nohdmi1=off
+  '';
+
+  # ============================================================
+  # CM5 Display Backlight Fix
+  # The kernel driver initializes backlight, but some boots fail.
+  # This service kicks it after boot as a reliable fallback.
+  # ============================================================
+  systemd.services.cm5-backlight-fix = {
+    description = "CM5 Display Backlight Fix";
+    after = [ "multi-user.target" ];
+    wantedBy = [ "multi-user.target" ];
+    serviceConfig = {
+      Type = "oneshot";
+      ExecStart = "${backlightFixScript}";
+    };
+  };
+
+  # ============================================================
+  # Internal USB Hub Enable (GPIO 23) — DISABLED
+  # This service freeze the CM5 because gpioset 0 23=1 writes
+  # to the wrong GPIO chip (BCM2712 native, not RP1).
+  # Enable manually after boot once the correct chip is confirmed:
+  #   gpioset 0 23=1   # on chip 0 (BCM2712, CORE_VOLT or critical)
+  #   gpioset 512 23=1 # on chip 512 (RP1, likely correct)
+  # ============================================================
+  # systemd.services.enable-gpio23-usb-hub = {
+  #   description = "Enable Internal USB Hub (GPIO 23)";
+  #   before = [ "network.target" ];
+  #   wantedBy = [ "multi-user.target" ];
+  #   serviceConfig = {
+  #     Type = "oneshot";
+  #     RemainAfterExit = true;
+  #     ExecStart = "${pkgs.libgpiod}/bin/gpioset 0 23=1";
+  #     ExecStop = "${pkgs.libgpiod}/bin/gpioset 0 23=0";
+  #   };
+  # };
+}

hosts/uConsole/disko-config.nix

@@ -0,0 +1,46 @@
+{ lib, ... }:
+{
+  disko.devices.disk.main = {
+    type = "disk";
+    device = "/dev/mmcblk0";
+    content = {
+      type = "gpt";
+      partitions = {
+        boot = {
+          name = "FIRMWARE";
+          size = "1G";
+          type = "EF00";
+          content = {
+            type = "filesystem";
+            format = "vfat";
+            mountpoint = "/boot/firmware";
+            mountOptions = [
+              "fmask=0022"
+              "dmask=0022"
+            ];
+          };
+        };
+        root = {
+          name = "NIXOS_UCM5";
+          size = "30G";
+          content = {
+            type = "filesystem";
+            format = "ext4";
+            mountpoint = "/";
+            mountOptions = [ "noatime" ];
+          };
+        };
+        home = {
+          name = "NIXOS_HOME";
+          size = "100%";
+          content = {
+            type = "filesystem";
+            format = "ext4";
+            mountpoint = "/home";
+            mountOptions = [ "noatime" ];
+          };
+        };
+      };
+    };
+  };
+}

hosts/uConsole/hardware-configuration.nix

@@ -0,0 +1,39 @@
+{ config, lib, pkgs, modulesPath, ... }:
+
+{
+  imports =
+    [ (modulesPath + "/installer/scan/not-detected.nix")
+    ];
+
+  boot.initrd.availableKernelModules = [ "xhci_pci" "usbhid" "usb_storage" "sdhci_pci" "nvme" ];
+  boot.initrd.kernelModules = [ ];
+  boot.extraModulePackages = [ ];
+
+  # Filesystems for NixOS install.
+  # mkForce overrides disko's auto-generated paths so we can use
+  # filesystem labels (by-label) which work with loop device installs.
+  # Disko will set its own paths when nixos-anywhere is used.
+  fileSystems."/" = lib.mkForce {
+    device = "/dev/disk/by-label/NIXOS_UCM5";
+    fsType = "ext4";
+    options = [ "noatime" ];
+  };
+
+  fileSystems."/boot/firmware" = lib.mkForce {
+    device = "/dev/disk/by-label/FIRMWARE";
+    fsType = "vfat";
+    options = [ "fmask=0022" "dmask=0022" ];
+  };
+
+  fileSystems."/home" = lib.mkForce {
+    device = "/dev/disk/by-label/NIXOS_HOME";
+    fsType = "ext4";
+    options = [ "noatime" ];
+  };
+
+  swapDevices = [ ];
+
+  nixpkgs.hostPlatform = lib.mkDefault "aarch64-linux";
+  hardware.enableRedistributableFirmware = true;
+  powerManagement.cpuFreqGovernor = lib.mkDefault "ondemand";
+}

modules/nixos/services/staging-vm.nix

@@ -1,415 +0,0 @@
-{ config, lib, pkgs, ... }:
-
-with lib;
-
-let
-  cfg = config.services.staging-vm;
-
-  # Resolve the first IP in the subnet (the gateway address for the NAT network)
-  networkIp = head (splitString "/" cfg.network.subnet);
-
-  # ── pr-test-vm helper script ──────────────────────────────────────────
-  pr-test-vm = pkgs.writeShellScriptBin "pr-test-vm" ''
-    set -euo pipefail
-
-    LIBVIRT_URI="qemu:///system"
-    STORAGE_POOL="${cfg.storagePool}"
-    VM_DIR="${cfg.dataDir}"
-    NETWORK="${cfg.network.name}"
-    SCRIPT_NAME="$(basename "$0")"
-
-    usage() {
-      cat <<EOF
-    Usage: $SCRIPT_NAME <command> [options]
-
-    Commands:
-      build   <nixos-config> [--name <name>]   Build VM image from a NixOS config
-      start   <vm-name>                         Start a VM
-      stop    <vm-name>                         Gracefully shut down a VM
-      destroy <vm-name>                         Force-power-off and undefine a VM
-      ssh     [user@]<vm-name>                  SSH into a running VM
-      console <vm-name>                         Connect to VM serial console
-      list                                      List all staging VMs
-      status  <vm-name>                         Show VM status
-      rebuild <vm-name>                         Redeploy the VM (stop + start)
-
-    Examples:
-      $SCRIPT_NAME build ./vm-config.nix --name my-test
-      $SCRIPT_NAME start my-test
-      $SCRIPT_NAME ssh root@my-test
-    EOF
-      exit 1
-    }
-
-    # Find the VM's IP address from the DHCP lease
-    vm_ip() {
-      local name="$1"
-      local mac
-      mac=$(${pkgs.libvirt}/bin/virsh -c "$LIBVIRT_URI" domiflist "$name" 2>/dev/null \
-        | ${pkgs.gawk}/bin/awk 'NR>2 && $1 ~ /^vnet/ {print $NF; exit}')
-      [ -z "$mac" ] && { echo "error: cannot find MAC for VM '$name'"; exit 1; }
-
-      local ip
-      ip=$(${pkgs.libvirt}/bin/virsh -c "$LIBVIRT_URI" net-dhcp-leases "$NETWORK" 2>/dev/null \
-        | ${pkgs.gawk}/bin/awk -v mac="$mac" '$0 ~ mac {gsub(/-.*/, "", $3); print $3; exit}')
-      [ -z "$ip" ] && { echo "error: no DHCP lease found for VM '$name' (MAC: $mac)"; exit 1; }
-      echo "$ip"
-    }
-
-    case "''${1:-help}" in
-      build)
-        shift
-        CONFIG="''${1:?Missing NixOS config path}"
-        VM_NAME="''${2:-}"
-        [ -f "$CONFIG" ] || { echo "error: config file not found: $CONFIG"; exit 1; }
-
-        # Extract name from --name flag or config basename
-        if [ "''${2:-}" = "--name" ] && [ -n "''${3:-}" ]; then
-          VM_NAME="$3"
-        elif [ -z "$VM_NAME" ] || [ "''${VM_NAME#--}" != "$VM_NAME" ]; then
-          VM_NAME="$(basename "$CONFIG" .nix)"
-        fi
-
-        BUILD_DIR="$VM_DIR/$VM_NAME"
-        IMAGE="$BUILD_DIR/disk-image.qcow2"
-
-        echo "==> Building VM '$VM_NAME' from config: $CONFIG"
-        mkdir -p "$BUILD_DIR"
-
-        # Build the NixOS VM derivation
-        nix build --no-link -f "$CONFIG" vm 2>&1 || {
-          # Fallback: try as flake output
-          echo "Trying flake build..."
-          nix build "''${CONFIG%/.nix}#nixosConfigurations.$VM_NAME.config.system.build.vm" --no-link 2>&1 || {
-            echo "error: failed to build VM (tried both import and flake)"
-            exit 1
-          }
-        }
-
-        echo "==> Build complete. Run 'pr-test-vm start $VM_NAME' to launch."
-        ;;
-
-      start)
-        VM_NAME="''${1:?Missing VM name}"
-        IMAGE="$VM_DIR/$VM_NAME/disk-image.qcow2"
-        [ -f "$IMAGE" ] || { echo "error: no disk image found at $IMAGE. Build first."; exit 1; }
-
-        # Check if already running
-        STATE=$(${pkgs.libvirt}/bin/virsh -c "$LIBVIRT_URI" domstate "$VM_NAME" 2>/dev/null || echo "undefined")
-        if [ "$STATE" = "running" ]; then
-          echo "VM '$VM_NAME' is already running."
-          exit 0
-        fi
-
-        echo "==> Starting VM '$VM_NAME'..."
-
-        # Undefine if defined but not running
-        if [ "$STATE" != "undefined" ]; then
-          ${pkgs.libvirt}/bin/virsh -c "$LIBVIRT_URI" undefine "$VM_NAME" 2>/dev/null || true
-        fi
-
-        # Define and start with virt-install
-        ${pkgs.virt-manager}/bin/virt-install \
-          --connect "$LIBVIRT_URI" \
-          --name "$VM_NAME" \
-          --memory "${toString cfg.memory}" \
-          --vcpus "${toString cfg.vcpus}" \
-          --disk "$IMAGE",bus=virtio \
-          --import \
-          --network network="$NETWORK",model=virtio \
-          --graphics none \
-          --console pty,target_type=virtio \
-          --serial pty \
-          --memballoon virtio \
-          --rng /dev/urandom \
-          --noautoconsole \
-          --os-variant detect=on,name=generic
-
-        echo "==> VM '$VM_NAME' started. Get IP with: pr-test-vm status $VM_NAME"
-        ;;
-
-      stop)
-        VM_NAME="''${1:?Missing VM name}"
-        echo "==> Stoping VM '$VM_NAME'..."
-        ${pkgs.libvirt}/bin/virsh -c "$LIBVIRT_URI" shutdown "$VM_NAME" 2>/dev/null && {
-          echo "Waiting for VM to shut down..."
-          for i in $(seq 1 30); do
-            STATE=$(${pkgs.libvirt}/bin/virsh -c "$LIBVIRT_URI" domstate "$VM_NAME" 2>/dev/null || echo "undefined")
-            [ "$STATE" != "running" ] && { echo "VM stopped."; exit 0; }
-            sleep 2
-          done
-          echo "warning: VM did not shut down gracefully, use 'destroy' for force"
-        } || {
-          echo "VM '$VM_NAME' not running or does not exist."
-        }
-        ;;
-
-      destroy)
-        VM_NAME="''${1:?Missing VM name}"
-        echo "==> Destroying VM '$VM_NAME'..."
-        ${pkgs.libvirt}/bin/virsh -c "$LIBVIRT_URI" destroy "$VM_NAME" 2>/dev/null || true
-        ${pkgs.libvirt}/bin/virsh -c "$LIBVIRT_URI" undefine "$VM_NAME" 2>/dev/null || true
-        echo "==> VM '$VM_NAME' destroyed and undefined."
-        ;;
-
-      ssh)
-        TARGET="''${1:?Usage: $SCRIPT_NAME ssh [user@]<vm-name>}"
-        # Split user@hostname if present
-        if echo "$TARGET" | ${pkgs.gnugrep}/bin/grep -q '@'; then
-          USER="''${TARGET%@*}"
-          VM_NAME="''${TARGET#*@}"
-        else
-          VM_NAME="$TARGET"
-          USER=""
-        fi
-
-        IP=$(vm_ip "$VM_NAME") || exit 1
-        if [ -n "$USER" ]; then
-          exec ${pkgs.openssh}/bin/ssh -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null "''${USER}@''${IP}"
-        else
-          exec ${pkgs.openssh}/bin/ssh -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null "$IP"
-        fi
-        ;;
-
-      console)
-        VM_NAME="''${1:?Missing VM name}"
-        exec ${pkgs.libvirt}/bin/virsh -c "$LIBVIRT_URI" console "$VM_NAME"
-        ;;
-
-      list)
-        echo "Staging VMs:"
-        ${pkgs.libvirt}/bin/virsh -c "$LIBVIRT_URI" list --all
-        echo ""
-        echo "Active networks:"
-        ${pkgs.libvirt}/bin/virsh -c "$LIBVIRT_URI" net-list
-        echo ""
-        echo "Storage pools:"
-        ${pkgs.libvirt}/bin/virsh -c "$LIBVIRT_URI" pool-list
-        ;;
-
-      status)
-        VM_NAME="''${1:?Missing VM name}"
-        echo "VM: $VM_NAME"
-        STATE=$(${pkgs.libvirt}/bin/virsh -c "$LIBVIRT_URI" domstate "$VM_NAME" 2>/dev/null || echo "not found")
-        echo "State: $STATE"
-        if [ "$STATE" = "running" ]; then
-          IP=$(vm_ip "$VM_NAME" 2>/dev/null || echo "N/A")
-          echo "IP: $IP"
-          ${pkgs.libvirt}/bin/virsh -c "$LIBVIRT_URI" dommemstat "$VM_NAME" 2>/dev/null | head -3 || true
-        fi
-        ;;
-
-      rebuild)
-        VM_NAME="''${1:?Missing VM name}"
-        "$0" destroy "$VM_NAME"
-        "$0" start "$VM_NAME"
-        ;;
-
-      help|--help|-h)
-        usage
-        ;;
-
-      *)
-        usage
-        ;;
-    esac
-  '';
-in
-{
-  options.services.staging-vm = {
-    enable = mkEnableOption "Staging VM infrastructure with libvirt/KVM";
-
-    network = {
-      name = mkOption {
-        type = types.str;
-        default = "staging";
-        description = "Name of the libvirt NAT network for staging VMs";
-      };
-
-      bridge = mkOption {
-        type = types.str;
-        default = "virbr1";
-        description = "Bridge interface name for the staging network";
-      };
-
-      subnet = mkOption {
-        type = types.str;
-        default = "192.168.122.0/24";
-        description = "NAT network subnet in CIDR notation";
-      };
-
-      dhcpStart = mkOption {
-        type = types.str;
-        default = "192.168.122.2";
-        description = "Start of the DHCP range";
-      };
-
-      dhcpEnd = mkOption {
-        type = types.str;
-        default = "192.168.122.254";
-        description = "End of the DHCP range";
-      };
-    };
-
-    storagePool = mkOption {
-      type = types.str;
-      default = "/var/lib/libvirt/images";
-      description = "Directory path for the libvirt storage pool";
-    };
-
-    dataDir = mkOption {
-      type = types.str;
-      default = "/var/lib/staging-vm";
-      description = "Directory for staging VM test data (images, cloud-init configs)";
-    };
-
-    memory = mkOption {
-      type = types.int;
-      default = 2048;
-      description = "Default RAM in MiB for staging VMs";
-    };
-
-    vcpus = mkOption {
-      type = types.int;
-      default = 2;
-      description = "Default number of vCPUs for staging VMs";
-    };
-  };
-
-  config = mkIf cfg.enable {
-    # ── libvirtd with QEMU/KVM ──────────────────────────────────────────
-    virtualisation.libvirtd = {
-      enable = true;
-
-      qemu = {
-        package = pkgs.qemu_kvm;
-        runAsRoot = true;
-
-        swtpm = {
-          enable = true;
-        };
-
-        ovmf = {
-          enable = true;
-          packages = [ pkgs.OVMF ];
-        };
-      };
-
-      # Allow the staging bridge for guest networking
-      allowedBridges = [ cfg.network.bridge ];
-    };
-
-    # ── System packages ─────────────────────────────────────────────────
-    environment.systemPackages = with pkgs; [
-      libvirt                # virsh, virt-admin
-      qemu_kvm               # QEMU/KVM
-      swtpm                  # Software TPM
-      OVMF                   # UEFI firmware for VMs
-      virt-manager           # GUI management
-      virt-viewer            # SPICE/VNC viewer
-      libguestfs             # virt-install, virt-customize, guestfish
-      cdrtools               # genisoimage for cloud-init ISOs
-      jq                     # JSON parsing
-      gawk                   # awk for DHCP lease parsing
-      gnugrep                # grep
-    ];
-
-    # ── User permissions ────────────────────────────────────────────────
-    users.users.gortium.extraGroups = [ "libvirtd" ];
-
-    # ── Directories ─────────────────────────────────────────────────────
-    systemd.tmpfiles.rules = [
-      "d ${cfg.storagePool} 0755 root root -"
-      "d ${cfg.dataDir} 0755 root root -"
-    ];
-
-    # ── Default NAT network definition ──────────────────────────────────
-    systemd.services.define-staging-network = {
-      description = "Define the staging libvirt NAT network";
-      after = [ "libvirtd.service" ];
-      requires = [ "libvirtd.service" ];
-      wantedBy = [ "multi-user.target" ];
-      before = [ "define-staging-pool.service" ];
-      serviceConfig = {
-        Type = "oneshot";
-        RemainAfterExit = true;
-      };
-      script = let
-        networkXml = pkgs.writeText "staging-network.xml" ''
-          <network>
-            <name>${cfg.network.name}</name>
-            <forward mode='nat'/>
-            <bridge name='${cfg.network.bridge}' stp='on' delay='0'/>
-            <ip address='${networkIp}' netmask='255.255.255.0'>
-              <dhcp>
-                <range start='${cfg.network.dhcpStart}' end='${cfg.network.dhcpEnd}'/>
-              </dhcp>
-            </ip>
-          </network>
-        '';
-      in ''
-        set -e
-        ${pkgs.libvirt}/bin/virsh -c qemu:///system net-info "${cfg.network.name}" 2>/dev/null && {
-          echo "Network '${cfg.network.name}' already exists"
-        } || {
-          echo "Defining network '${cfg.network.name}'..."
-          ${pkgs.libvirt}/bin/virsh -c qemu:///system net-define "${networkXml}"
-        }
-        ${pkgs.libvirt}/bin/virsh -c qemu:///system net-autostart "${cfg.network.name}"
-        # Start the network if not already active
-        STATE=$(${pkgs.libvirt}/bin/virsh -c qemu:///system net-state "${cfg.network.name}" 2>/dev/null || echo "inactive")
-        if [ "$STATE" != "active" ]; then
-          ${pkgs.libvirt}/bin/virsh -c qemu:///system net-start "${cfg.network.name}"
-        fi
-        echo "Network '${cfg.network.name}' is ready."
-      '';
-    };
-
-    # ── Storage pool definition ─────────────────────────────────────────
-    systemd.services.define-staging-pool = {
-      description = "Define the staging libvirt storage pool";
-      after = [ "libvirtd.service" "define-staging-network.service" ];
-      requires = [ "libvirtd.service" ];
-      wantedBy = [ "multi-user.target" ];
-      serviceConfig = {
-        Type = "oneshot";
-        RemainAfterExit = true;
-      };
-      script = ''
-        set -e
-        ${pkgs.libvirt}/bin/virsh -c qemu:///system pool-info staging 2>/dev/null && {
-          echo "Storage pool 'staging' already exists"
-        } || {
-          echo "Defining storage pool 'staging' at ${cfg.storagePool}..."
-          ${pkgs.libvirt}/bin/virsh -c qemu:///system pool-define-as \
-            --name staging --type dir --target "${cfg.storagePool}"
-        }
-        ${pkgs.libvirt}/bin/virsh -c qemu:///system pool-autostart staging
-        STATE=$(${pkgs.libvirt}/bin/virsh -c qemu:///system pool-state staging 2>/dev/null || echo "inactive")
-        if [ "$STATE" != "running" ]; then
-          ${pkgs.libvirt}/bin/virsh -c qemu:///system pool-build staging
-          ${pkgs.libvirt}/bin/virsh -c qemu:///system pool-start staging
-        fi
-        echo "Storage pool 'staging' is ready."
-      '';
-    };
-
-    # ── Firewall rules for libvirt guests ───────────────────────────────
-    networking.firewall = {
-      # Trust the bridge interface to allow guest traffic
-      trustedInterfaces = [ cfg.network.bridge ];
-
-      extraCommands = mkAfter ''
-        # Allow forwarding between the staging bridge and the outside world
-        iptables -I FORWARD -i ${cfg.network.bridge} -j ACCEPT 2>/dev/null || true
-        iptables -I FORWARD -o ${cfg.network.bridge} -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT 2>/dev/null || true
-
-        # NAT for guest outbound traffic
-        iptables -t nat -I POSTROUTING -s ${cfg.network.subnet} -j MASQUERADE 2>/dev/null || true
-      '';
-    };
-
-    # ── pr-test-vm helper script ────────────────────────────────────────
-    environment.systemPackages = [ pr-test-vm ];
-  };
-}

overlays/reticulum.nix

@@ -0,0 +1,92 @@
+final: prev: let
+  python3 = final.python3;
+  pyPkgs = python3.pkgs;
+in
+  {
+    reticulumStack = python3.pkgs.buildPythonApplication rec {
+      pname = "reticulum";
+      version = "1.2.9";
+      format = "setuptools";
+      src = pyPkgs.fetchPypi {
+        pname = "rns";
+        inherit version;
+        sha256 = "554814231c237b9caacf8df669312e57dd7d3f84b6d4810125087d1a79a75d75";
+      };
+      patchPhase = ''
+        # Fix license_files syntax: ("LICENSE") is a string not tuple
+        # Newer setuptools iterates over it char by char, fails on 'S'
+        substituteInPlace setup.py \
+          --replace-fail 'license_files = ("LICENSE")' 'license_files = ("LICENSE",)'
+      '';
+      propagatedBuildInputs = with pyPkgs; [ cryptography pyserial ];
+      doCheck = false;
+      pythonImportsCheck = [ "RNS" ];
+      meta = with final.lib; {
+        description = "Self-configuring, encrypted and resilient mesh networking stack";
+        homepage = "https://reticulum.network/";
+        license = licenses.mit;
+        platforms = platforms.linux;
+      };
+    };
+
+    lxmf = python3.pkgs.buildPythonApplication rec {
+      pname = "lxmf";
+      version = "0.9.8";
+      format = "setuptools";
+      src = pyPkgs.fetchPypi {
+        inherit pname version;
+        sha256 = "30f39f3a975a049c12ee2cfceb3261d24cb5adec881c6821f7354464b3f3650c";
+      };
+      propagatedBuildInputs = [ final.reticulumStack ];
+      doCheck = false;
+      pythonImportsCheck = [ "LXMF" ];
+      meta = with final.lib; {
+        description = "Lightweight Extensible Message Format for Reticulum";
+        homepage = "https://github.com/markqvist/lxmf";
+        license = licenses.mit;
+        platforms = platforms.linux;
+      };
+    };
+
+    nomadnet = python3.pkgs.buildPythonApplication rec {
+      pname = "nomadnet";
+      version = "1.1.1";
+      format = "setuptools";
+      src = pyPkgs.fetchPypi {
+        inherit pname version;
+        sha256 = "fa13b64a10e75b705a58024815ab72451700aa726af96d415ba99dec28dfc40a";
+      };
+      propagatedBuildInputs = with pyPkgs; [ final.reticulumStack final.lxmf urwid qrcode ];
+      doCheck = false;
+      pythonImportsCheck = [ "nomadnet" ];
+      meta = with final.lib; {
+        description = "Nomad Network — resilient mesh communications platform";
+        homepage = "https://github.com/markqvist/NomadNet";
+        license = licenses.mit;
+        platforms = platforms.linux;
+      };
+    };
+
+    rnsh = python3.pkgs.buildPythonApplication rec {
+      pname = "rnsh";
+      version = "0.1.7";
+      format = "setuptools";
+      src = pyPkgs.fetchPypi {
+        inherit pname version;
+        sha256 = "9cb72f25abb1c6d300f8014b264184ff78f592fe88e36094938012990b797c93";
+      };
+      propagatedBuildInputs = [ final.reticulumStack ];
+      doCheck = false;
+      pythonImportsCheck = [ "rnsh" ];
+      meta = with final.lib; {
+        description = "Remote shell over Reticulum";
+        homepage = "https://github.com/acehoss/rnsh";
+        license = licenses.mit;
+        platforms = platforms.linux;
+      };
+    };
+  }
+  # meshtastic may not exist in all nixpkgs versions (e.g. not in 25.11)
+  // prev.lib.optionalAttrs (prev ? meshtastic) {
+    inherit (prev) meshtastic;
+  }