You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/install-guides/sbx.md
+96-12Lines changed: 96 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: Docker Sandboxes (sbx)
3
3
4
-
description: Install Docker Sandboxes (sbx) on macOS with Apple Silicon to run AI coding agents in isolated Arm Linux microVMs using Apple's virtualization framework.
4
+
description: Install Docker Sandboxes (sbx) on macOS with Apple Silicon or Arm Linux to run AI coding agents in isolated microVMs.
5
5
6
6
minutes_to_complete: 10
7
7
@@ -13,7 +13,6 @@ additional_search_terms:
13
13
- sandbox
14
14
- microvm
15
15
- containers
16
-
- apple silicon
17
16
18
17
author: Jason Andrews
19
18
@@ -30,21 +29,35 @@ layout: installtoolsall
30
29
Docker Sandboxes (`sbx`) is a standalone CLI from Docker for running AI coding agents in isolated microVMs. Each sandbox gets its own filesystem, network, and Docker daemon, so agents can install packages, modify files, and run containers without touching your host system.
31
30
32
31
{{% notice Note %}}
33
-
`sbx` is not available on Arm Linux.
32
+
Arm Linux support is available in `sbx` version 0.33 and later.
34
33
{{% /notice %}}
35
34
36
35
On macOS with Apple Silicon, `sbx` uses Apple's virtualization framework to launch Arm Linux (Ubuntu) microVMs. You don't need Docker Desktop.
37
36
37
+
On Arm Linux, `sbx` uses the KVM hypervisor to launch microVMs. KVM requires bare metal and does not work on virtual machines.
38
+
38
39
## Before you begin
39
40
41
+
### macOS prerequisites
42
+
40
43
You need:
41
44
42
45
- A Mac with Apple Silicon (M1 or later) running macOS Sonoma (version 14) or later.
43
-
- A [Docker Hub](https://hub.docker.com/) account to authenticate `sbx`.
44
46
-[Homebrew](https://brew.sh/) installed.
47
+
- A [Docker Hub](https://hub.docker.com/) account to authenticate `sbx`.
48
+
49
+
### Arm Linux prerequisites
50
+
51
+
You need:
52
+
53
+
- An Arm Linux system running Ubuntu 24.04 LTS or later on aarch64 architecture.
54
+
- Kernel-based Virtual Machine (KVM) enabled on bare metal hardware.
55
+
- A [Docker Hub](https://hub.docker.com/) account to authenticate `sbx`.
45
56
46
57
## Install the sbx CLI
47
58
59
+
### macOS installation
60
+
48
61
Install `sbx` using Homebrew:
49
62
50
63
```bash
@@ -53,6 +66,76 @@ brew install docker/tap/sbx
53
66
54
67
Homebrew installs the `sbx` binary at `/opt/homebrew/bin/sbx`.
55
68
69
+
### Arm Linux installation
70
+
71
+
On Arm Linux, `sbx` requires KVM acceleration. KVM does not typically work on virtual machines. It requires bare metal.
72
+
73
+
Install and run the `kvm-ok` command to confirm KVM is available.
74
+
75
+
Install `kvm-ok` on Debian-based Linux distributions:
76
+
77
+
```bash
78
+
sudo apt install cpu-checker -y
79
+
```
80
+
81
+
To check if KVM is available, run:
82
+
83
+
```console
84
+
sudo kvm-ok
85
+
```
86
+
87
+
If KVM is available, the output is similar to:
88
+
89
+
```output
90
+
INFO: /dev/kvm exists
91
+
KVM acceleration can be used
92
+
```
93
+
94
+
If KVM is not available, the output is similar to:
95
+
96
+
```output
97
+
INFO: /dev/kvm does not exist
98
+
HINT: sudo modprobe kvm
99
+
INFO: For more detailed results, you should run this as root
100
+
HINT: sudo /usr/sbin/kvm-ok
101
+
```
102
+
103
+
After KVM is available, install `sbx` using the appropriate .deb package for your Ubuntu version. First, check your Ubuntu version:
104
+
105
+
```bash
106
+
grep VERSION_ID /etc/os-release
107
+
```
108
+
109
+
{{% notice Note %}}
110
+
The following commands use Docker Sandboxes version 0.33.0. The same commands work with other versions. Replace the file used in these steps with the file for your version of choice. To find the latest release and available Ubuntu versions, see the [sbx releases page](https://github.com/docker/sbx-releases/releases).
111
+
{{% /notice %}}
112
+
113
+
For Ubuntu 26.04, download and install the .deb package:
After installing the CLI, verify that the installation was successful.
@@ -66,13 +149,13 @@ sbx version
66
149
```
67
150
68
151
{{% notice Note %}}
69
-
The following output shows the version at the time this guide was written. Homebrew installs the latest available version. To find the latest release, see the [sbx releases page](https://github.com/docker/sbx-releases/releases).
152
+
The following output shows the version at the time this guide was written. To find the latest release, see the [sbx releases page](https://github.com/docker/sbx-releases/releases).
0 commit comments