CLI usage
The exact text each binary prints when you run it with no arguments.
Generated from the sources when the site is built. If a flag is not here, the binary does not have it.
corail
corail — a Docker clone in Zig
Usage:
corail version
corail run [--memory BYTES] [--pids-limit N] [--cpus N] [--name NAME]
[--hostname NAME] [-d] [-i] [-t] [--rm] [--cap-add CAP]... [--cap-drop CAP]... [-e K=V]... [--label K=V]...
[--seccomp-trace]
[-v host:ctr[:ro]]... [--net host|none|bridge|capsule:ID]
[-p h:c]... <target> [-- <cmd> [args...]]
corail ps
corail stop [--grace SECONDS] <id>
corail rm <id>
corail logs <id>
corail attach <id> (terminal of a capsule started with run -d -t)
corail pull [--platform os/arch] <image>[:tag]
corail images
corail rmi <image>[:tag]
corail prune (delete cached blobs and unfinished capsule directories; keeps extracted layers)
corail exec <id> [-it] [--user user[:group]] -- <cmd> [args...]
corail net repair (root: set the bridge up again, with its NAT rules)
corail dial <id> <port> (stdio ↔ capsule loopback TCP)
corail run-raw <rootfs-dir> -- <cmd> [args...] (Phase 1: no cgroups/state)
corail x86-selftest (VM only, CORAIL_X86=emu)
<target> is an image reference (e.g. alpine, nginx:1.27 — pulled
automatically if not cached yet) or a path to an already-extracted
rootfs directory (must start with /, ./, or ../). <cmd> is optional for
image targets: it replaces the image's default Cmd; its Entrypoint (if
any) still runs. Runs rootless via user namespaces (no sudo needed);
as root it uses plain namespaces. --memory accepts a byte count or a
k/m/g suffix, e.g. --memory 256m. --net bridge (with -p port mapping)
requires root; rootless supports --net host (default) and --net none.
recify
recify — control the coraild control plane
Usage:
recify apply [-f <reef.json|reef.yaml>] (default: ./reef.json)
recify get atolls|at [-n ns] [-A] [-o json|name] [-w]
recify get atoll <name>
recify describe atoll <name>
recify delete atoll <name>
recify rm <name>
recify logs <atoll> [capsule]
recify exec <atoll> [-c capsule] -- <cmd>...
recify port-forward <atoll> <local>:<remote> [-c capsule]
recify run <name> --image <image> [-e K=V]... [--restart Always|Never|OnFailure]
[--net none|host|bridge] [-n ns] -- [cmd...]
recify up | down | status
recify version
recify completion bash|zsh
sonar has no flags; see its keys.