DOKK / manpages / debian 12 / runc / runc-run.8.en
runc-run(8) System Manager's Manual runc-run(8)

runc-run - create and start a container

runc run [option ...] container-id

The run command creates an instance of a container from a bundle, and starts it. You can think of run as a shortcut for create followed by start.

Path to the root of the bundle directory. Default is current directory.

Path to an AF_UNIX socket which will receive a file descriptor referencing the master end of the console's pseudoterminal. See docs/terminals ⟨https://github.com/opencontainers/runc/blob/master/docs/terminals.md⟩.

Detach from the container's process.

Specify the file to write the initial container process' PID to.

Disable the use of the subreaper used to reap reparented processes.

Do not use pivot root to jail process inside rootfs. This should not be used except in exceptional circumstances, and may be unsafe from the security standpoint.

Do not create a new session keyring for the container. This will cause the container to inherit the calling processes session key.

Pass N additional file descriptors to the container (stdio + $LISTEN_FDS + N in total). Default is 0.

Keep container's state directory and cgroup. This can be helpful if a user wants to check the state (e.g. of cgroup controllers) after the container has exited. If this option is used, a manual runc delete is needed afterwards to clean an exited container's artefacts.

runc(8).