40 Releases 41 Tags

RSS Feed

• v0.1.0 a9c4f408a9

  Compare

  v0.1.0 — MVP Pre-Release

  mward4 released this 2026-04-30 00:02:29 -04:00 | 55 commits to main since this release

  Phase 1-4 release: OpenPXE MVP

  First public release — every protocol leg works in CI tests; needs real-hardware validation next.

  What you can do with this image

  • Boot Linux ISOs (Ubuntu, Debian, RHEL family, Arch, Alpine, openSUSE) via PXE on BIOS or x86_64 UEFI clients
  • Boot Windows installers via vanilla Microsoft-signed WinPE + SMB share (no test certs, no testsigning toggle)
  • Mount remote NFSv3 / NFSv4.1 shares as ISO sources without copying images into the PVC
  • Drive Gated Deployment: many clients wait at a queue, operator picks one ISO, all launch simultaneously
  • Watch the live tracing log + run whitelisted commands from the Terminal tab in the web UI

  Pull

  docker pull gitea.milesward.dev/mward4/openpxe:0.1.0
  

  Run on Unraid

  See deploy/unraid/README.md. Drop deploy/unraid/openpxe.xml into /boot/config/plugins/dockerMan/templates-user/ for a one-click Docker template.

  Image details

  • Base: debian:12-slim
  • Architecture: linux/amd64
  • Size: ~97 MB
  • Runs as uid 10001 (entrypoint chowns bind mounts as root, then drops via gosu)
  • Required cap: NET_BIND_SERVICE for ports 67/69/80
  • Recommended cap (optional): SYS_ADMIN if you want NFS share mounting

  Tests

  56 passing across the workspace: 16 core + 1 dhcp-proxy + 8 http-api unit + 13 integration + 12 iso-store + 6 tftp.

  Known gaps deferred to next phase

  • Real-hardware Windows boot validation (plumbing tested only)
  • Real-hardware NFS validation (mount manager tested only)
  • Full ISO9660 + Joliet + Rock Ridge (current parser is plain ISO9660)
  • UEFI HTTP Boot (option 60 = HTTPClient)
  • Multi-replica deployment

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)