Sign in Sign up

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, copy it onto a machine drive with the FUSE client, 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 vmlinux.wasm image that any machine can boot. 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.