lab-ipxe-osMulti-OS iPXE & Cloud-Init Hub

A high-performance, lightweight network autoinstall server for Bare-metal and Virtual Machines powered by Bun & TypeScript.

Get Started

View on GitHub

Download Releases

🚀

Standalone Single Binary

No Node.js or complex dependencies required. Pre-packaged with an embedded Web UI, SQLite database, and HTTP Byte-Range static asset server.

🔄

Anti-Boot Loop Mechanism

Smart MAC-based State Machine in SQLite. Once provisioning completes, nodes automatically boot from local disk instead of re-installing.

🐧

Multi-OS Installation Engine

Automated provisioning support for Ubuntu (Subiquity & Cloud-Init), Talos Linux (immutable K8s without SSH), and openSUSE Leap Micro (Combustion/Ignition).

📊

Web UI & Live WebSocket Logs

Modern management dashboard to monitor provisioning state, configure node inventories via SQLite, and stream live terminal logs over WebSocket.

📦

Smart Asset Mirroring

Automated downloading, extraction, and local hosting of ISOs, vmlinuz kernels, and initrd ramdisks with HTTP Byte-Range support.

⚙️

CI/CD & Kubernetes Out-of-the-Box

Automated single-node bootstrapping for K3s and RKE2, ArgoCD GitOps integration, remote Kubeconfig generation, and phone-home webhooks.

Quick Start

1. Download the Standalone Executable

Download the precompiled binary for your architecture from GitHub Releases:

bash

# Example for Linux x64
tar -xzf lab-ipxe-os-v1.0.0-linux-x64.tar.gz
cd lab-ipxe-os
./lab-ipxe-os

2. Configure DHCP / iPXE Chaining

Direct your DHCP server or iPXE client to the boot script endpoint:

ini

chain http://<SERVER-IP>:3000/boot.ipxe?mac=${net0/mac}

lab-ipxe-osMulti-OS iPXE & Cloud-Init Hub

Standalone Single Binary

Anti-Boot Loop Mechanism

Multi-OS Installation Engine

Web UI & Live WebSocket Logs

Smart Asset Mirroring

CI/CD & Kubernetes Out-of-the-Box

Quick Start ​

1. Download the Standalone Executable ​

2. Configure DHCP / iPXE Chaining ​

3. Explore Detailed Documentation ​

Quick Start

1. Download the Standalone Executable

2. Configure DHCP / iPXE Chaining

3. Explore Detailed Documentation