Sign in Sign up

Getting started

Quickstart

Boot your first machine in a couple of minutes: get a machine, power it on in a browser tab, type at a real Linux shell, and (optionally) mount its drive on your own computer. Nothing to install for the in-browser part — a modern desktop browser is enough.

1. Create an account

Sign up and verify your email. You can browse Explore and open public machines without an account, but you need one to create or fork machines of your own.

2. Get a machine

A machine is a versioned root filesystem that boots — it looks like a repository, but launching it gives you a running Linux system (see Machines). Two ways to get one:

  • Fork an existing machine. Open one from Explore — for example a bash + coreutils image — and fork it. Your fork is a writable copy under your own account.
  • Create one at brintos.io/new. Choose the machine image repository type, then start from one of our templates, fork any machine you can read, or start from scratch with an empty drive.

3. Power it on

On the machine's page, press Launch machine, then Power on. The machine boots entirely in your tab — its root filesystem is served from cloud storage, and the kernel image named in its machine spec boots against it. The launch page gives you:

  • A serial console — a terminal pane that shows the kernel's actual boot log (dmesg), verbatim, and then your shell prompt. What you type goes to the guest.
  • A screen — a framebuffer canvas showing the machine's display. Its resolution is measured from the window at power-on and follows the window when you resize; keyboard and pointer input over the screen go to the guest as real input events.
  • Live dials — machine, storage, and network telemetry while the machine runs.

When boot finishes, the machine's init program is running as PID 1 — on the stock bash/coreutils images, that's a shell on the console.

4. Work at the shell

It's real Linux — a real kernel, real processes, a real filesystem. Try it:

uname -a
ls /
echo "hello from my machine" > /root/hello.txt
cat /root/hello.txt

Writes go back to the machine's cloud filesystem. Reload the tab, power the machine on again, and /root/hello.txt is still there — the drive is durable, not a throwaway sandbox.

5. Mount the drive on your computer (optional)

brintos-fs, the open-source FUSE client, mounts a machine's filesystem as an ordinary local directory. Get it from Downloads, then:

brintos login                                # opens a browser to authorize
mkdir -p /tmp/mymachine
brintos mount <you>/<repo> /tmp/mymachine    # read-write on machines you own

cp some-file /tmp/mymachine/root/
sync                                         # flush write-back cache to the server

Files you copy in appear on the machine — browse them in the web UI or power the machine on and read them from the shell. Mounts are read-write when your account has write access to the repo (your own machines and forks); public machines you don't own mount read-only.

Next steps

  • Machines — the machine spec, snapshots, and the launch surface.
  • Developer guide — build your own packages, or your own kernel.
  • Git over SSH — work with brintOS repositories from git.