DEV Community

TekDT
TekDT

Posted on

SEZOY: When Windows Installs and Linux Boot-Over-Network Become a One-Touch Experience - The "Never Touch the ISO" Philosophy

SEZOY is closed-source (prebuilt installer, no code walkthrough) - this post focuses on operating experience and hands-on testing, not source internals.
Enter fullscreen mode Exit fullscreen mode

TABLE OF CONTENTS

Why netboot still matters in 2026
Architecture from an operator's view
Preset / Profile Group / Catalog: the automation trio
Two DHCP modes and the coexistence problem
Windows: automatic yet controllable
Linux: multi-distro netboot + hardware diagnostics
Monitoring, backup, API: the dev part
Hands-on 1: test over the Internet without installing SEZOY
Hands-on 2: run your own server in 5 minutes
Requirements, ports, FAQ
Enter fullscreen mode Exit fullscreen mode
  1. Why netboot still matters in 2026

For devs and homelabbers the problem is never "install one machine" but "install many machines, many times, many configs, with minimal downtime." USB sticks + scattered scripts don't scale. Heavy stacks like WDS / MDT / SCCM work but cost setup and care.

SEZOY sits in the middle: one Windows PC as the deployment server, everything else network-boots. Web dashboard at https://localhost:5893, multi-language English / Vietnamese / Chinese / Japanese, tray icon. Clients are bare metal or VMs (VMware / Proxmox / Hyper-V / VirtualBox) doing Legacy / UEFI PXE, iPXE or wired / wireless HTTP Boot.

One rule throughout: ISOs stay pristine. New build = swapping one file. Everything else arrives at boot over HTTP.

  1. Architecture from an operator's view

No source deep-dive, just the flow so you can picture it:

SEZOY SERVER (Windows)
├─ Web dashboard :5893 - templates, groups, catalog, logs, backup, API
├─ Boot HTTP :6824 - high-speed channel at deploy time
├─ Full DHCP / ProxyDHCP + smart filtering - coexist or self-serve
├─ TFTP tuned for LAN + VPN - small seed files only
├─ WiFi AP for wireless boot - Windows hotspot based
├─ Linux boot - distro detect, add-on packs, per-ISO menus
└─ Offline storage + API + backup + audit
│ L2: LAN / VLAN / VPN / WiFi AP

PXE ROM => iPXE (signed if SecureBoot ON) => Menu => pick ISO/Profile
├─ Windows: install env => partition => load image => inject drivers
│ => apply unattend => OOBE => apps => desktop
└─ Linux: load kernel + system over net => merge add-on layer => live boot

Notable for infra folks: the server knows which stage each client is at and hands the right boot file per stage. Small seeds first, then straight to HTTP - no hangs on picky virtual NICs like vmxnet3, stable over long-distance VPN. A loop guard shows a help screen instead of retrying forever.

  1. Preset / Profile Group / Catalog: the automation trio

    Preset: one complete recipe + unique tag (LAB-ROOM-A): computer name (* random or LAB-A-* rules), key (empty = existing digital license), timezone, language / keyboard, domain join, welcome screens, accounts, auto-logon, first commands, privacy, 4-stage scripts (CMD / PowerShell / VBScript in the browser), apps to install, junk to remove, drivers / updates to load. Preview + pre-flight checks, full duplicate / load / delete / search.
    Profile Group: rules mapping machines to templates by vendor, model, chip, boot style, RAM / disk, MAC prefix, parts, SecureBoot, NIC type… with priority and match-all / match-any. A simulator previews placement before real boot.
    Catalog: the shared driver / patch / app / junkware store every template references. Fix once, benefit everywhere. Integrity-checked, logged. Windows app tab (search / download-for-offline) and Microsoft patch tab (filter by code, security / critical). Fully offline once downloaded.

One ISO serves many groups: accounting one template, lab another - ideal for mixed fleets.

  1. Two DHCP modes and the coexistence problem

    ProxyDHCP (default, recommended): shares the net with your router / pfSense / OPNsense. SEZOY only adds boot info, never fights for IPs.
    Full DHCP: SEZOY owns client IPs, only for private nets (test VPN, back-to-back cable, VM lab over VPN, isolated VLAN). Editable in UI: server IP, netmask, gateway, DNS (default 8.8.8.8), pool (test server uses .200–.250).
    Safety: exact-NIC binding, separate WiFi address, no leaked 169.254.x.x - lessons from long-distance VPN tests.
    WiFi AP for Wireless HTTP Boot: prefers Windows Mobile Hotspot, detects capable cards, finds the gateway (usually 192.168.137.1). Editable SSID / password (default SEZOY_Boot / 00000000, 8-char minimum). SEZOY never owns WiFi IPs itself; Hotspot does, SEZOY only adds boot info. No capable card? Warning only; wired boot works.

  2. Windows: automatic yet controllable

Two modes from one ISO: pre-selected edition => fully automatic; empty => stock Setup for manual pick; Linux ISO => always the automatic path. Multi-mode with automatic-first fallback supported.

Dynamic drivers: catalog-resident, injected at deploy time. Adding a driver = one catalog entry, ISO untouched. Update / feature packs pre-first-boot. Skipped (saving seconds per machine) when unneeded.
Realtime edition read: clicking an ISO lists Edition + Index + Arch + Language + Build instantly, no mount, no extraction. Optional keep-one-edition for lighter, faster, lower-RAM boot.
SecureBoot: signed Windows boot files (with revoked-build blocklist); per-family Linux signing. Unsigned ISOs get a clear reason screen instead of a hang.
OOBE / Privacy / Users / Scripts / Apps: slim 24H2+ welcome (no forced online account / WiFi / BitLocker), two-layer privacy + one-tap tweaks, multiple local accounts + post-install auto-demote, 4-stage scripts, silent per-app-reported installs, protected junk removal.
Watch and control: Full-HD screens in the browser, per-machine shots, continue / custom / shutdown / reboot, progress %, per-machine logs, 5-minute session expiry.
Enter fullscreen mode Exit fullscreen mode
  1. Linux: multi-distro netboot + hardware diagnostics

Ubuntu / Mint, Debian, Kali, Arch, CentOS / Rocky / Alma / Fedora, antiX, Deepin… auto-detected, boot entries auto-built, missing firmware fetched, compressed in-ISO systems handled.

Boot-time composition merges the stock system with add-on packs (drivers, firmware, WiFi, diagnostics, remote-control) into one working system - WiFi works, installable - original ISO untouched. 100% Ventoy / iVentoy-pack compatible. Built once per distro, faster later. HTTP + network-disk delivery.

Built-in live hardware-check ISO: graphical info, deep CPU / RAM / disk / memory tests, temps, risk score, report export, guided assistant - the "receive old box, check, then install Windows" flow.

  1. Monitoring, backup, API: the dev part

    Overview: machine totals, running jobs, health, CPU / RAM / disk bars.
    Machines: MAC / hostname search, status / template / stage filters, details + history, last-seen.
    Live: auto-refreshing online grid, large / fullscreen shots, shutdown / reboot / remote / commands, blinking control state.
    Logs & reports: node / event / date filters, paging, export; CSV / HTML / PDF with size / date / download / delete.
    Backup: encrypted on-box, one-click, restore with overwrite warning, daily / weekly / monthly schedule + time + retention + last / next display.
    Accounts: password login (default-password warning), min-4-char change, remembered session.
    API + docs: login / password, template and group CRUD, bulk CSV import, online + screenshots, remote deploy, logs / stats, reports, server status, machine-code management (shown-once, masked, enable / revoke, call examples in-page). Two layers: web session + per-machine boot code (expiry, granular build / fetch / report permissions, revoke / renew). Everything important logged. Enough for lab portals, per-class templates, bot / dashboard integrations.
    First-run tool pack: genuine Microsoft fetcher + Server 2016 / 2022 / 2025 (multi-thread, resume), ISO open / split, offline Windows app store, driver packs with % / speed / ETA, self-update, one-tap installer build with pre-checks.

  2. Hands-on 1: test over the Internet without installing SEZOY

Test server: machine B 192.168.138.1, public VPN Hub. You are machine C, joining the same L2 over VPN and bridging your VM straight into the VPN NIC. Shared dashboard: https://192.168.138.1:5893.

Install SoftEther VPN Client (tick Client) => create SEZOY-VPN adapter => new connection: Host vpn196703493.softether.net, port 443, Hub SEZOY-HUB, user / pass tester99 => Connected. Errors 1 / 2 / 691 => recheck hub / user / port-443 firewall.
Install VMware Workstation Pro => Virtual Network Editor (Admin) => free VMnet (e.g. VMnet2, Bridged) => Bridged to = exactly the SoftEther NIC (never Automatic) => VM uses Custom VMnet2. VM: UEFI, ≥4GB RAM, ≥40GB disk, Network Boot first.
Power on => PXE => DHCP from 192.168.138.1 => menu in 5–15s => pick shared ISO + tester profile => deploy => record time, SecureBoot ON / OFF, Legacy / UEFI, errors + MAC + screenshots. Clean shutdown + Disconnect VPN when done.
Enter fullscreen mode Exit fullscreen mode

Common: wrong bridge (straight to BIOS), TFTP timeout from MTU / firewall, slow HTTP from WAN jitter (don't reboot in loops), home IP from still-Automatic VMnet.

Shared-testing notes: modest box + WiFi + Internet, only ~50 IPs, one VM per person, light boot before full Windows, never stop the host Boot Server, report with config + screenshots + VN time, check maintenance notices first.

  1. Hands-on 2: run your own server in 5 minutes

Open https://localhost:5893 => serving NIC (LAN / VPN, not WAN NAT), check the "SEZOY Service" firewall rule => add ISOs (copy in or fetch directly), click for live editions, pick an edition => automatic, leave empty => stock => build presets + groups (simulator first), pool / gateway / DNS / SSID => Start Boot Server (ProxyDHCP with DHCP present, Full on isolated nets, WiFi AP if wanted) => PXE-boot clients => pick ISO => auto-assigned template => auto install => screenshots / progress / reports. Enable auto backup.

  1. Requirements, ports, FAQ

Server: Windows 10/11 x64 or Server 2022/2025, Admin, ≥8GB RAM (16GB+ for many machines), disk for ISOs (Windows 5–7GB each, Linux 2–4GB each), hotspot-capable WiFi card only for wireless boot. Client: physical / VM with PXE or HTTP Boot, ≥4GB RAM for the install env. Network: same L2, Internet once, fully offline after. Ports: 5893 dashboard HTTPS, 6824 boot HTTP, 67/68 addressing, 69 seeds, 10809 network disk if used.

FAQ: modify ISOs? No. SecureBoot off? No. Ventoy-compatible? Yes. Forgot a tag? Search or activity log. Own app? Bundled API docs + access code. Lost config? Restore from backup. Wireless needs? AP-capable server card + HTTP-Boot-capable client.

Tested via VPN? Leave VM config, distro / edition, SecureBoot, boot time and a menu screenshot so SEZOY can improve. Thanks dev.to!

Top comments (0)