Headless mode

Browser

import { Nodepod } from '@r1ck404/nodepod';

const pod = await Nodepod.boot({ headless: true });

Headless browser mode defaults the service worker and watermark off. Filesystem, packages, spawning, and programmatic HTTP remain available within the limits of the browser environment.

Node.js and Bun

import { Nodepod } from '@r1ck404/nodepod/headless';

const pod = await Nodepod.boot();

The headless entry uses worker threads and exposes virtual server ingress on loopback. It does not need a browser DOM, xterm.js, or service-worker setup.

Always call pod.teardown() in application shutdown and test cleanup. It resolves once the loopback ingress has closed its listening socket and any keep-alive connections, so await it before binding the same port again or ending a test.