@sandboxxjs/cloudflare-isolator

Docker-based code execution server for SandboX.

What is this?

A standalone HTTP server (compiled to binary) that executes code in Docker containers.

Used by CloudflareContainerIsolator in sandboxjs.

Usage

$3

``bash
npm install @sandboxxjs/cloudflare-isolator

Start server

cloudflare-isolator

Or with custom port

PORT=9000 cloudflare-isolator
`

$3

`typescript
import { createSandbox } from "@sandboxxjs/sandbox";

const sandbox = createSandbox({
runtime: "node",
isolator: "cloudflare", // Automatically starts cloudflare-isolator
});
`

API

$3

Execute code in Docker container.

Request:

`json
{
"code": "console.log('hello')",
"runtime": "node",
"env": { "NODE_ENV": "production" },
"timeout": 30000
}
`

Response:

`json
{
"success": true,
"stdout": "hello",
"stderr": "",
"exitCode": 0,
"metadata": {
"executionTime": 450,
"timestamp": "2026-01-15T19:00:00.000Z"
}
}
`

$3

Health check.

Response:

`json
{
"status": "ok",
"runtime": "bun"
}
`

Deployment to Cloudflare

`bash


Deploy to Cloudflare Workers + Containers


cd services/cloudflare-isolator
bun run deploy
`

Supported Runtimes

- node - Node.js 22
- python - Python 3.11
- bash` - Alpine Linux

Requirements

- Docker (for local execution)
- Cloudflare account (for cloud deployment)

License

MIT