BrowserPod 3.0 runs Rust BrowserPod 3.0 runs unmodified Rust programs in the browser Announcement
Using a coding agent? Not sure where to start? Talk to us
Sign up for Edge Get an Edge API key, with 1,000 free hours Contact us Talk to the team

Loads on demand

Loads only what the workload needs

Base images aren't downloaded at boot. Blocks stream in as programs ask for them, and everything a pod writes stays in the browser's own storage.

A filesystem built for the browser

01

Streamed, not downloaded

Blocks arrive as they're read and are cached locally, so a pod starts without fetching the whole image.

02

A POSIX-like filesystem

Real file semantics, with bash, git, curl, grep, ripgrep, vi, npm and pnpm in the base image.

03

Persistent or ephemeral

Pass a storageKey to keep a disk between visits, or leave it out for a fresh disk on every boot.

04

Stored in the browser

Writes are kept in the Origin Private File System or IndexedDB. Nothing is uploaded.

How the filesystem loads

BrowserPod's filesystem behaves like Ext2, with real POSIX semantics. The base image isn't downloaded when a pod boots. Its blocks stream on demand, over a WebSocket from our disk servers or from any HTTP server that supports byte-range requests.

Every block a program reads is cached locally, and everything it writes stays in the browser, in the Origin Private File System by default or in IndexedDB. Nothing is uploaded, and a returning user's pod reuses what's already stored instead of fetching it again.

A storageKey picks a persistent disk that survives reloads. Leave it out and the pod runs ephemerally, with a fresh disk on every boot and old disks cleaned up for you.

What you need to know

Your users' work lives in /home

The working directory is /home/user, and /home is kept when BrowserPod upgrades while the rest of the disk resets.

One tab per persistent disk

A storageKey disk opens in one tab at a time and raises a catchable error if it's already open, so you can handle it in your UI.

Keep a disk between visits

A storageKey names a persistent disk. Files you create through the API are there for programs in the pod.

app.js
import { BrowserPod } from "@leaningtech/browserpod";

// A named disk survives reloads
const pod = await BrowserPod.boot({ storageKey: "my-project" });

await pod.createDirectory("/home/user/app", { recursive: true });
const file = await pod.createFile("/home/user/app/index.js", "utf-8");
await file.write(`console.log("Hello from the pod");`);
await file.close();

Questions

Where are files stored?

In the browser, in the Origin Private File System by default or IndexedDB. Nothing is uploaded.

Can I open the same disk in two tabs?

A persistent disk opens in one tab at a time, with a clear error if it's open elsewhere. Ephemeral pods work in as many tabs as you like.

What's in the base image?

bash, git, curl, grep, openssl, vi, BusyBox coreutils, an ssh client, ripgrep, fd, npm, npx and pnpm, alongside Node.js.

How do I get files into a pod?

Write them from your page with createFile, openFile and createDirectory, or fetch them from inside the pod. git clone works when the pod is connected through BrowserPod Edge.

What happens to files when BrowserPod updates?

Everything in /home is kept, and the rest of the disk resets to the new base image, so users' projects survive upgrades.

Stay informed with BrowserPod news

BrowserCode: a browser-based coding playground, powered by WebAssemblyBrowserCode is a free, open source, fully client-side coding playground. Open a tab, pick a template, clone a repo or pick an agent and start building. No account, no installs, no servers, no setup. Ana GabySoftware Engineer @ Leaning TechnologiesBeyond WASI: Running any Rust application in the browser with BrowserPod 3.0BrowserPod can now run real Rust programs in the browser, compiled from unmodified source with stock rustc and cargo. Yuri IozzelliSenior Software Engineer @ Leaning TechnologiesA Linux-like kernel in a browser tab - deep dive in the BrowserPod architectureHow the BrowserPod kernel supports running many Linux applications concurrently in the browser using WebAssembly. Alessandro PignottiCTO @ Leaning TechnologiesBrowserPod 2.0: in-browser WebAssembly sandboxes. Run git, bash, node, python...BrowserPod 2.0 ships with a real bash shell, git, and core Linux utilities. Yuri IozzelliSenior Software Engineer @ Leaning TechnologiesBrowserPod: universal in-browser sandbox powered by Wasm (starting with Node.js)Stefano De Rossi, Alessandro PignottiCEO @ Leaning TechnologiesBrowserPod: WebAssembly in-browser code sandboxes for Node, Python, and RailsBrowserPod Beta is live: zero latency in-browser code sandboxes in WebAssembly for Node, Python and Rails. Alessandro Pignotti, Stefano De RossiCTO @ Leaning TechnologiesBrowserPod: In-browser full-stack environments for IDEs and Agents via WasmBrowserPod is a WebAssembly-based, client-side container that brings full-stack dev environments to the browser, ideal for web IDEs, docs, and AI agents.Alessandro Pignotti, Stefano De RossiCTO @ Leaning Technologies