mirror of
https://github.com/harivansh-afk/sandbox-agent.git
synced 2026-04-15 22:03:48 +00:00
83 lines
2.5 KiB
Text
83 lines
2.5 KiB
Text
---
|
|
title: "Docker"
|
|
description: "Build and run the daemon in a Docker container."
|
|
---
|
|
|
|
<Warning>
|
|
Docker is not recommended for production. Standard Docker containers don't provide sufficient isolation for running untrusted code. Use a dedicated sandbox provider like E2B or Daytona for production workloads.
|
|
</Warning>
|
|
|
|
## Quick Start
|
|
|
|
Run sandbox-agent in a container with agents pre-installed:
|
|
|
|
```bash
|
|
docker run --rm -p 3000:3000 \
|
|
-e ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY" \
|
|
-e OPENAI_API_KEY="$OPENAI_API_KEY" \
|
|
alpine:latest sh -c "\
|
|
apk add --no-cache curl ca-certificates libstdc++ libgcc bash && \
|
|
curl -fsSL https://releases.rivet.dev/sandbox-agent/latest/install.sh | sh && \
|
|
sandbox-agent install-agent claude && \
|
|
sandbox-agent install-agent codex && \
|
|
sandbox-agent server --no-token --host 0.0.0.0 --port 3000"
|
|
```
|
|
|
|
<Note>
|
|
Alpine is required because Claude Code is built for musl libc. Debian/Ubuntu images use glibc and won't work.
|
|
</Note>
|
|
|
|
Access the API at `http://localhost:3000`.
|
|
|
|
## TypeScript with dockerode
|
|
|
|
```typescript
|
|
import Docker from "dockerode";
|
|
import { SandboxAgent } from "sandbox-agent";
|
|
|
|
const docker = new Docker();
|
|
const PORT = 3000;
|
|
|
|
const container = await docker.createContainer({
|
|
Image: "alpine:latest",
|
|
Cmd: ["sh", "-c", [
|
|
"apk add --no-cache curl ca-certificates libstdc++ libgcc bash",
|
|
"curl -fsSL https://releases.rivet.dev/sandbox-agent/latest/install.sh | sh",
|
|
"sandbox-agent install-agent claude",
|
|
"sandbox-agent install-agent codex",
|
|
`sandbox-agent server --no-token --host 0.0.0.0 --port ${PORT}`,
|
|
].join(" && ")],
|
|
Env: [
|
|
`ANTHROPIC_API_KEY=${process.env.ANTHROPIC_API_KEY}`,
|
|
`OPENAI_API_KEY=${process.env.OPENAI_API_KEY}`,
|
|
].filter(Boolean),
|
|
ExposedPorts: { [`${PORT}/tcp`]: {} },
|
|
HostConfig: {
|
|
AutoRemove: true,
|
|
PortBindings: { [`${PORT}/tcp`]: [{ HostPort: `${PORT}` }] },
|
|
},
|
|
});
|
|
|
|
await container.start();
|
|
|
|
// Wait for server and connect
|
|
const baseUrl = `http://127.0.0.1:${PORT}`;
|
|
const client = await SandboxAgent.connect({ baseUrl });
|
|
|
|
// Use the client...
|
|
await client.createSession("my-session", {
|
|
agent: "claude",
|
|
permissionMode: "default",
|
|
});
|
|
```
|
|
|
|
## Building from Source
|
|
|
|
To build a static binary for use in minimal containers:
|
|
|
|
```bash
|
|
docker build -f docker/release/linux-x86_64.Dockerfile -t sandbox-agent-build .
|
|
docker run --rm -v "$PWD/artifacts:/artifacts" sandbox-agent-build
|
|
```
|
|
|
|
The binary will be at `./artifacts/sandbox-agent-x86_64-unknown-linux-musl`.
|