Run Docker containers inside Vercel Sandbox

Vercel Sandbox now supports installing and running Docker inside a sandbox. An agent can build containers, install system packages, and modify files without touching your host system.

Install Docker, start the daemon, and serve a containerized application:

1
import { Sandbox } from "@vercel/sandbox";
2

3
const sandbox = await Sandbox.create();
4
await sandbox.runCommand({
5
  sudo: true,  
6
  cmd: "dnf",  
7
  args: ["install", "-y", "docker"]
8
});
9

10
// Start docker daemon and wait for it to be ready
11
await sandbox.runCommand({ sudo: true, cmd: "dockerd", detached: true });
12
await sandbox.runCommand({
13
  cmd: "sh", 
14
  args: [ "-lc",  "until sudo docker info >/dev/null 2>&1; do sleep 1; done"] 
15
});
16

17
await sandbox.runCommand({
18
  cmd: "docker",  
19
  args: [
20
    "run", "--rm", "-d",
21
    "--name", "redis",
22
    "redis:alpine"  
23
  ]
24
});
25
await sandbox.runCommand({
26
  cmd: "docker",  
27
  args: ["exec", "redis", "redis-cli", "PING" ]
28
});

Docker in a Sandbox is useful for running containerized services like Redis or Postgres as test dependencies, validating container images before deploying, or previewing applications served from a container. Combined with persistent sandboxes, the Docker installation and pulled images carry over between sessions.

As well as adding support for Docker, sandboxes now support FUSE filesystem drivers and VPN clients, unlocking unlimited capabilities to what can be built.

Learn more about these new system specifications in the documentation.