Documentation

brintOS docs

Build, share, and launch Linux machines in your browser or on your computer. Transfer files and images between machines, and choose live or a backup snapshot for each launch.

What is brintOS?

brintOS runs real Linux machines in the browser and in local Node processes. Every machine is a versioned root filesystem you can build, fork, and launch — like a repository, but it boots. This documentation walks through the concepts, the day-to-day workflow, and the surfaces you can automate against.

Where to start

• Quickstart — boot your first machine in a couple of minutes.
• Launching — browser, embeds, headless Node, and offline ext4 images, with version selection and command-line arguments.
• Files & images — upload files, download backups, and import ext4 images.
• Core concepts — machines, snapshots, and the filesystem model.
• Command line — drive brintOS from your terminal.
• Storage & filesystems — how machine data is stored, and how to transfer it.

Conventions used in these docs

Commands you run in a shell are shown in monospace blocks. Inline names like brintos.js refer to commands, files, or identifiers. Notes call out things worth remembering:

node brintos.js --help