Commands
Run corail with no arguments for the full usage text.
These commands are the same on Linux and on macOS (Intel and Silicon). On macOS they run the Linux engine inside the microVM.
Subcommands
corail run [flags] <target> [-- cmd args…]: start a container.corail ps: list running containers.corail stop [--grace SECONDS] <id>: stop a container.corail rm <id>: delete a container.corail logs <id>: print a container's output.corail exec <id> -- cmd args…: run a command inside a container.corail pull [--platform os/arch] <image>[:tag]: fetch an image.corail images: list cached images.corail rmi <image>[:tag]: remove an image.corail prune: delete cached blobs; keeps extracted layers.corail dial <id> <port>: connect stdio to a TCP port on the container's loopback.corail version: print the version.
corail run
<target> is an image reference such as alpine or nginx:1.27 (pulled if not cached), or a path to an extracted rootfs directory starting with /, ./ or ../. A command after -- replaces the image's default Cmd.
-d: run in the background.--rm: delete the container when it exits.--name NAME,--hostname NAME: names.-e K=V: environment variable, repeatable.--label K=V: label, repeatable.-v host:ctr[:ro]: bind mount, repeatable.--memory BYTES: memory limit; acceptsk,m,gsuffixes, e.g.256m.--cpus N,--pids-limit N: CPU and process limits.--net host|none|bridge|capsule:ID: network mode. Rootless supportshost(default) andnone;bridgeand-pneed root.-p host:ctr: publish a port, repeatable (root only).