Kinds and sizes
The kinds of box bb-box knows, the backends that can offer each, and each kind’s sizes as shipped. The configuration’s kinds section changes the sizes (see the configuration reference).
| Kind | What it is | OS | Architecture | Desktop | GPU | Device | Backends |
|---|---|---|---|---|---|---|---|
linux |
A Linux box for builds, backend services and the agent’s own work. | linux | x86_64 | no | no | no | Proxmox LXC, Proxmox QEMU, SSH host pool, Docker, microsandbox, Hetzner Cloud, Namespace, boat.dev |
linux-desktop |
A Linux desktop on a GPU, for computer use, browsers and app development. | linux | x86_64 | yes | yes | no | Proxmox LXC, Docker |
linux-desktop-cpu |
A Linux desktop drawn by the CPU, for computer use and browsers. | linux | x86_64 | yes | no | no | Proxmox LXC, Proxmox QEMU, Docker, microsandbox, Hetzner Cloud, Namespace, boat.dev |
linux-desktop-wayland-cpu |
A Linux desktop on Wayland (Sway), drawn by the CPU, for computer use, browsers and apps built for Wayland. X11-only apps do not run there. | linux | x86_64 | yes, Wayland | no | no | Proxmox LXC, Docker, Hetzner Cloud, Namespace |
linux-arm64 |
A Linux box on arm64. amd64 container images and x86_64 binaries do not run there. | linux | arm64 | no | no | no | Tart, microsandbox, Hetzner Cloud |
linux-arm64-desktop-cpu |
A Linux desktop on arm64, drawn by the CPU. amd64 container images and x86_64 binaries do not run there. | linux | arm64 | yes | no | no | Tart, microsandbox, Hetzner Cloud |
macos |
A Mac for builds and Apple’s tools. | macos | arm64 | no | no | no | SSH host pool, Tart, Namespace |
macos-desktop |
A macOS desktop for computer use and app development. | macos | arm64 | yes | no | no | SSH host pool, Tart, Namespace |
windows-desktop |
A Windows desktop for computer use, browsers and Windows apps. | windows | x86_64 | yes | no | no | Proxmox QEMU |
windows-arm64-desktop |
A Windows desktop on arm64, for computer use, browsers and Windows apps. x64 apps run under Windows’ emulation, more slowly; x64 drivers do not. | windows | arm64 | yes | no | no | Tart |
ios |
An iPhone or iPad in the iOS Simulator, for installing, running and testing iOS apps. It runs on a macOS VM, or in a slot on a shared Mac or VM, and is shared with a person in the panel. | macos | arm64 | no | no | iOS | SSH host pool, Tart, Namespace (on shared iOS hosts only) |
android |
A phone, foldable or tablet in the Android emulator, for installing, running and testing Android apps. It runs on a Linux VM, and is shared with a person in the panel. | linux | x86_64 | no | no | Android | Proxmox QEMU, boat.dev |
Devices
The devices an ios or android box can boot (063), which box_acquire’s device and bb box acquire --device take by name. An image offers some of them, each with its runtime; the first an offer lists is the kind’s default. The screen is in the device’s own pixels, upright.
| Device | Platform | Form | Screen | Scale |
|---|---|---|---|---|
iPhone 18 Pro |
iOS | phone | 1206x2622 | 3 |
iPhone 17 |
iOS | phone | 1206x2622 | 3 |
iPad Pro 13-inch (M5) |
iOS | tablet | 2064x2752 | 2 |
Pixel 8 |
Android | phone | 1080x2400 | 2.625 |
Pixel Fold |
Android | foldable | outer 1080x2092, inner 2208x1840; closed, half-open, open | 2.625, 2.625 |
Pixel Tablet |
Android | tablet | 2560x1600 | 2 |
Aliases
An alias asks for a kind with features, from the offers that have them (041).
| Alias | Kind | Features |
|---|---|---|
linux-docker |
linux |
docker |
linux-arm64-docker |
linux-arm64 |
docker |
linux-vm |
linux |
kernel |
linux-kvm |
linux |
kvm |
Sizes
Each kind has the presets small, medium, large, a default preset, and a largest size a custom size may reach. A disk left out is the image’s own.
| Kind | small | medium | large | Default | Largest |
|---|---|---|---|---|---|
linux |
2 cores, 4 GiB memory | 4 cores, 8 GiB memory | 8 cores, 16 GiB memory | small | 16 cores, 32 GiB memory, 256 GiB disk |
linux-desktop |
4 cores, 8 GiB memory | 8 cores, 16 GiB memory | 16 cores, 32 GiB memory | small | 32 cores, 64 GiB memory, 256 GiB disk |
linux-desktop-cpu |
4 cores, 8 GiB memory | 8 cores, 16 GiB memory | 16 cores, 32 GiB memory | small | 32 cores, 64 GiB memory, 256 GiB disk |
linux-desktop-wayland-cpu |
4 cores, 8 GiB memory | 8 cores, 16 GiB memory | 16 cores, 32 GiB memory | small | 32 cores, 64 GiB memory, 256 GiB disk |
linux-arm64 |
2 cores, 4 GiB memory | 4 cores, 8 GiB memory | 8 cores, 16 GiB memory | small | 16 cores, 32 GiB memory, 256 GiB disk |
linux-arm64-desktop-cpu |
4 cores, 8 GiB memory | 8 cores, 16 GiB memory | 16 cores, 32 GiB memory | small | 32 cores, 64 GiB memory, 256 GiB disk |
macos |
4 cores, 8 GiB memory | 6 cores, 16 GiB memory | 8 cores, 32 GiB memory | small | 16 cores, 64 GiB memory, 256 GiB disk |
macos-desktop |
4 cores, 8 GiB memory | 6 cores, 16 GiB memory | 8 cores, 32 GiB memory | small | 16 cores, 64 GiB memory, 256 GiB disk |
windows-desktop |
4 cores, 8 GiB memory | 8 cores, 16 GiB memory | 16 cores, 32 GiB memory | small | 32 cores, 64 GiB memory, 256 GiB disk |
windows-arm64-desktop |
4 cores, 8 GiB memory | 8 cores, 16 GiB memory | 16 cores, 32 GiB memory | small | 32 cores, 64 GiB memory, 256 GiB disk |
ios |
4 cores, 8 GiB memory | 6 cores, 16 GiB memory | 8 cores, 32 GiB memory | medium | 16 cores, 64 GiB memory, 256 GiB disk |
android |
8 cores, 16 GiB memory | 12 cores, 24 GiB memory | 16 cores, 32 GiB memory | small | 32 cores, 64 GiB memory, 256 GiB disk |