Guide · 5 mins

What is a container?

A container is one process, started from an OCI image.

The image is filesystem layers from a registry. The process sees those layers as its root directory. corail calls that running container a capsule.

On Linux, corail starts the capsule on the host. Rootless. Its own namespaces and cgroups. On macOS, the same command starts the capsule in a Linux VM. One VM stays up per store.

registry

filesystem layers

OCI image

cached after the first pull

capsule

one process. The image is its root directory.

Linux

on the host. Rootless. Namespaces and cgroups.

macOS

a Linux VM. One per store.

A container is that process. corail calls it a capsule, on the host or in the VM.

corail run pulls the image when it is not already cached, starts the process, and exits. Pass -d and the container keeps running after the command returns.