Joseph M OBrien joe

0 Followers · 0 Following

• Joined on 2026-03-15

Repositories Projects Packages Public Activity Starred Repositories

miniboxctl (0.19.0)

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

Installation

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 miniboxctl@0.19.0

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

About this package

Alternative axum-based management CLI for the minibox container runtime

miniboxctl

Alternative management CLI for minibox with an Axum-based HTTP/SSE API. Provides job tracking, structured container lifecycle management, and a server-sent events stream for real-time output.

Status

Work in progress. Core job execution and SSE streaming are implemented; full feature parity with minibox-cli is incomplete.

Architecture

miniboxctl runs an Axum HTTP server that proxies requests to miniboxd via the Unix socket client. Container runs are tracked as "jobs" with persistent log history.

API

Method	Path	Description
POST	/jobs	Create and start a container job
GET	/jobs	List all jobs
GET	/jobs/{id}	Get job status
GET	/jobs/{id}/logs	SSE stream of job output
DELETE	/jobs/{id}	Stop and remove a job

Running

./target/release/miniboxctl

# Custom listen address and minibox socket
miniboxctl --listen 127.0.0.1:8080 --socket /run/minibox/minibox.sock

Dependencies

ID	Version
anyhow	^1
axum	^0.8
chrono	^0.4
clap	^4
futures	^0.3
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
axum	^0.8
http-body-util	^0.1
tower	^0.5

Details

Cargo

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

2

Project Site

Repository Site

MIT OR Apache-2.0

28 KiB

Assets (1)

miniboxctl-0.19.0.crate 28 KiB

Versions (1) View all

0.19.0 2026-05-31