Guides
Developer guide
How to get up and running building for a brintOS machine — packages (ordinary C/C++ programs compiled into wasm-native Linux executables) and the kernel itself. Pick a path below.
Install the toolchain Fetch and build the shared toolchain — the pinned LLVM, the HwjsCoroutinize pass, the wasmcc/wasmld drivers, and our musl. Do this first; both guides below build on it. Build locally, run on brintOS Compile a package with the brintOS toolchain on your own machine, upload it through the file browser, and run it in the browser on brintos.io. Build the Linux kernel Build our fork of Linux 6.12 for the wasm32-hwjs target into a revisioned WASM kernel for a compatible machine image. Build locally, run locally Boot a machine on your own hardware with the HardwareJS Node harness — a local root filesystem and an interactive console, no browser.
New here? Start by installing the toolchain, then walk the
whole loop in Build locally, run on brintOS. A
brintOS package must be produced by the brintOS toolchain; a
generic
.wasm built with Emscripten or wasi-libc will not run on a machine.