v1.2.0 Stable · Webware Architecture · 11 Platforms

The kernel that
runs anywhere.

WebNux is a Webware kernel — it runs natively in the browser and on real hardware. One codebase. Eleven architectures. Legacy BIOS, UEFI, and U-Boot. Drop one file into a webpage, or flash an image to bare metal.

index.html — web target
<!-- 1. link the kernel -->
<script src="https://webnux.pages.dev/kernel-os.js"></script>

<!-- 2. your OS starts here -->
<script>
  WebNux.onReady(nx => {
    nx.proc.spawn({ name: 'myapp' });
    nx.net.socket();
  });
</script>
⎘  All kernel files & downloads
Webware architecture
11 CPU architectures
Legacy BIOS + UEFI + U-Boot
Zero dependencies (web)
Open source
Architecture

Webware.
A new kind of kernel.

Most kernels are hardware-only. Most web runtimes are browser-only. WebNux is neither. The Webware architecture means the kernel is designed from the ground up to run in both worlds simultaneously — not as a port, but as a first-class citizen of each.

🌐
Web target
Drop a single <script> tag into any HTML page. The kernel boots a full OS environment in the browser — process manager, memory allocator, TCP/IP stack, BSD sockets, SysV IPC, ELF loader, capabilities, /proc filesystem, and more. No npm. No build tools. No dependencies.
WASM Single file Firebase cloud Universal app store
💾
Hardware target
Flash a kernel image to real hardware and boot it directly. Full bare-metal support for storage drivers (AHCI, ATA, NVMe, SD card), network drivers (e1000, RTL8139, VirtIO), FAT32 & EXT2 filesystems, framebuffer, UART, and platform-specific boot sequences. Supports any machine from 40 years old to brand new.
x86 / x86_64 ARM32 / ARM64 RISC-V MIPS PowerPC
Supported platforms

11 architectures.
One kernel.

WebNux compiles to every major CPU architecture. The same kernel source — different targets. Hardware that's 40 years old works just as well as modern silicon.

🖥️
x86_64
64-bit Intel/AMD
🖥️
x86
32-bit legacy
📱
ARM64
AArch64
📱
ARM32
ARMv7 / Android
⚡
RISC-V 64
RV64GC
⚡
RISC-V 32
RV32GC
🔷
MIPS 64
MIPS64r2
🔷
MIPS 32
MIPS32r2
🟡
PowerPC 64
PPC64 / LE
🟡
PowerPC 32
PPC32
🌐
Browser
WebAssembly
Boot environments
Legacy BIOS
Two-stage bootloader (stage1 ASM + stage2 C). Works on any x86 machine regardless of age. MBR-based boot.
UEFI
Native UEFI PE binaries for x86_64, x86, and ARM64. BOOTX64.EFI, BOOTIA32.EFI, BOOTAA64.EFI.
U-Boot
Device tree blob support for ARM and RISC-V boards. Sideloadable on Android via fastboot with unlocked bootloader.
What it does

A kernel that does
the boring parts.

WebNux handles everything a real kernel does — whether you're building a web OS or running on bare metal. Boot, drivers, memory management, networking, filesystems, and a universal app ecosystem.

⬛
Clean Boot Screen
Pure black screen with spinner on web. Clean UART + framebuffer output on hardware. No clutter, no branding you didn't ask for.
💾
Storage Drivers
AHCI, ATA, NVMe, and SD card drivers. FAT32 and EXT2 filesystem support. Works on drives from any era.
🌐
Universal App Store
Apps built for any WebOS using WebNux are automatically compatible with every other WebOS — declare metadata, go global.
🔌
Network Drivers
e1000, RTL8139, and VirtIO network drivers. BSD socket API, full TCP/IP stack, WiFi and Bluetooth headers on hardware.
⚡
One File (Web)
Drop in a single <script> tag. PMM, VMM, TCP/IP, ELF loader, kprobes, ACPI — everything. No npm, no config.
🔓
Not Unix. Not Linux.
Despite the name, WebNux doesn't use Unix or Linux. It's its own Webware architecture built from scratch.
How to use

Up and running
in three steps.

Web or hardware — the kernel manages its own boot sequence. You only write code for your OS.

1
Web: Add kernel-os.js to your page
One script tag. The full WebNux kernel boots automatically. No npm, no build tools.
<script src="https://webnux.pages.dev/kernel-os.js"></script>
2
Hardware: Flash a kernel image
Download the image for your architecture from the releases page. On x86/x86_64: boot the EFI binary directly. On ARM32/Android: use fastboot with an unlocked bootloader. On RISC-V / MIPS / PPC 32-bit: use the provided build_*.sh scripts, then flash via U-Boot.
# x86_64 UEFI — copy to EFI partition
cp BOOTX64.EFI /EFI/BOOT/BOOTX64.EFI

# Android (fastboot)
fastboot boot kernel.img
3
Web: Call onReady() and start your OS
Everything inside the callback runs after full boot. Use the WebNux unified API or the classic WebOSKernel API.
WebNux.onReady(nx => {
  nx.proc.spawn({ name: 'shell' });
  const fd = nx.net.socket(nx.net.AF.INET, nx.net.SOCK.STREAM);
  const pfn = nx.mm.alloc(0);
});
Boot order

The kernel starts first.
Then everything else.

Services load in strict order — the kernel is always stable before any OS code runs.

Kernel
1. Core Subsystems Boot
EventBus → Router → Middleware → Services → PMM → VMM → KSched → Pipes → BlockDev → Entropy → Sockets → IPC → Capabilities → ELF → kprobes → /proc → ACPI → cpufreq. Any failure shows the Web-Error Menu with the exact code.
Kernel
2. Built-in Routes Register
Internal routes like /kernel/info and /kernel/services register. These cannot be overridden by OS code.
Auto
3. App Store Layer Initialises
Kernel connects to the global app registry. Any WebOS using WebNux with valid app metadata can see and install apps from other WebOSes automatically.
Creator
4. onReady() Fires
Once everything above is stable, the kernel calls your onReady() callback. Both WebOSKernel.onReady() and WebNux.onReady() fire at this point.
Creator
5. Plugins Load
Plugins installed via kernel.plugin() run after onReady. Each can register services, routes, and middleware without touching the kernel core.
Auto
6. OS Is Live
Boot screen gone. Your OS has full control of the page and full access to the kernel API.
Global app store

Build once.
Run on every WebOS.

Apps built for any WebOS powered by WebNux are automatically compatible with every other WebOS using the same kernel — declare valid metadata and go global.

How the universal app layer works
Each app declares a metadata object the kernel reads. Valid metadata with store: true makes the app globally discoverable and installable from any WebOS on the same kernel version.
id *required
com.yourname.appname
name *required
"My App"
version *required
"1.0.0"
kernelVersion *required
"1.2.0"
entry
"https://cdn.com/app.js"
store
true
category
"productivity"
permissions
["storage", "network"]
🛠️
Creator builds app
App declares valid kernel metadata with store: true
🌐
Kernel registers it
App becomes visible in the global registry shared across all WebOSes
📲
Any WebOS installs it
Any WebOS with the same kernel version can discover and install the app
Download

Get WebNux 1.2.0 Stable.

Web kernel is always available at the CDN. Hardware kernel images are in the GitHub releases.

🌐
Web Kernel
The base 1.0.0 web kernel, always live at the CDN. Drop a script tag and go — no download needed. Or grab kernel-os.js from the releases for offline use.
⬇ Download kernel-os.js
💾
Hardware Kernel
Full multi-architecture release. Includes kernel images for all platforms, EFI binaries for x86/ARM64, and build scripts for 32-bit cross-compilation.
⬇ Latest Release on GitHub
🔧
Build from Source
64-bit targets need no scripts — standard toolchains work. 32-bit cross-compilation has dedicated shell scripts: build_arm32.sh, build_mips32.sh, build_ppc32.sh, build_riscv32.sh.
↗ View all source links
📋
Release Channels
Three channels per version:

Stable — recommended for use
Beta — feature-complete, testing
Nightly — latest builds, may be rough
↗ All Releases
Web kernel modes

One kernel family.
Five configurations.

Each mode ships as its own kernel file, purpose-built for a specific type of WebOS.

1
OS
Standard
Recommended
The full WebNux kernel — all subsystems. PMM, VMM, TCP/IP, BSD sockets, SysV IPC, ELF loader, capabilities, kprobes, /proc, ACPI, cpufreq, kernel modules, AppStore, Cloud. Exposes both WebOSKernel and WebNux globals.
Features: Boot screen · EventBus · Router · AppStore · Cloud · PMM · VMM · TCP/IP · Sockets · IPC · ELF · Caps · /proc · ACPI · WebNux API
<script src="https://webnux.pages.dev/kernel-os.js"></script>
kernel-os.js
2
SMS
Messaging
Trimmed for conversation-driven WebOSes. Core subsystems + cloud layer, configured for messaging interfaces rather than a full desktop.
Features: Boot screen · EventBus · Router · Cloud (send/subscribe) · Plugins
<script src="https://webnux.pages.dev/kernel-sms.js"></script>
kernel-sms.js
3
Tools
Headless
No UI, no boot screen, no app launching. Boots instantly with four built-in tool services: dev console, inspector, calculator, notes.
Features: EventBus · Router · Services · Dev tools · Utility tools · Cloud
<script src="https://webnux.pages.dev/kernel-tools.js"></script>
kernel-tools.js
4
OS with Login
Standard
Auth
Everything in Mode 1 plus a built-in Firebase Auth login gate. Your OS code only runs after a successful sign-in.
Features: All of Mode 1 · Firebase Auth · Login gate · User session
<script src="https://webnux.pages.dev/kernel-os-login.js"></script>
kernel-os-login.js
5
SMS with Login
Messaging
Auth
Everything in Mode 2 plus Firebase Auth. Conversations and cloud data scoped to the authenticated user.
Features: All of Mode 2 · Firebase Auth · Login gate · User session
<script src="https://webnux.pages.dev/kernel-sms-login.js"></script>
kernel-sms-login.js