dockerbox (0.19.0)

Published 2026-05-31 14:33:06 -05:00 by joe

Set up this registry in the Cargo configuration file (for example ~/.cargo/config.toml):

[registry]
default = "gitea"

[registries.gitea]
index = "sparse+" # Sparse index
# index = "" # Git

[net]
git-fetch-with-cli = true

To install the package using Cargo, run the following command:

cargo add dockerbox@0.19.0

For more information on the Cargo registry, see the documentation.

Docker API shim that translates Docker API calls to the minibox protocol

dockerbox

HTTP-over-Unix-socket shim that translates Docker API calls to the minibox protocol. Allows Docker clients (docker, docker-compose, etc.) to interact with miniboxd without modification.

Architecture

dockerboxd listens on a Unix socket and forwards requests to miniboxd, translating between the Docker v2 HTTP API and the minibox JSON-over-newline protocol.

Socket: /run/dockerbox/dockerbox.sock (override with DOCKERBOX_SOCKET)
Upstream: MINIBOX_SOCKET (default /run/minibox/minibox.sock)

API Coverage

Endpoint	Status
`POST /containers/create`	Implemented
`POST /containers/{id}/start`	No-op (minibox starts at `Run` time)
`GET /containers/json`	Implemented
`GET /containers/{id}/json`	Implemented
`DELETE /containers/{id}`	Implemented
`GET /containers/{id}/logs`	Stub
`GET /images/json`	Implemented
`POST /images/create` (pull)	Implemented
`GET /networks`	In-memory stub
`GET /volumes`	Stub (maps to `~/.local/share/dockerbox/volumes/`)
`GET /_ping`	Implemented
`GET /info`	Implemented

ID Translation

minibox uses 16-character hex container IDs; Docker expects 64. dockerboxd pads IDs with trailing zeros for compatibility.

Socket Security

Default permissions: 0o660 (root-owned, group-accessible)
Set DOCKERBOX_SOCKET_GROUP=docker to allow group members to connect without sudo
Set DOCKERBOX_SOCKET_MODE=0640 to restrict permissions further
All operations reaching miniboxd are still gated by SO_PEERCRED (UID 0 only)

Running

sudo ./target/release/dockerboxd

# With custom sockets
DOCKERBOX_SOCKET=/tmp/docker.sock MINIBOX_SOCKET=/run/minibox/minibox.sock sudo ./target/release/dockerboxd

# Point Docker CLI at dockerbox
docker -H unix:///run/dockerbox/dockerbox.sock ps

ID	Version
anyhow	^1
async-trait	^0.1
axum	^0.8
base64	^0.22
bytes	^1
chrono	^0.4
futures	^0.3
minibox-client	^0.19.0
minibox-core	^0.19.0
serde	^1
serde_json	^1
thiserror	^2
tokio	^1
tokio-stream	^0.1
tracing	^0.1
tracing-subscriber	^0.3
uuid	^1
http-body-util	^0.1
tower	^0.5
nix	^0.29

Details

Cargo

2026-05-31 14:33:06 -05:00

Project Site

Repository Site

MIT OR Apache-2.0

32 KiB

Assets (1)

dockerbox-0.19.0.crate 32 KiB

Versions (1) View all

0.19.0

2026-05-31