runc/man/runc-run.8.md

% runc-run "8"

NAME

runc-run - create and start a container

SYNOPSIS

runc run [option ...] container-id

DESCRIPTION

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.

OPTIONS

--bundle|-b path

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

--console-socket path

Path to an AF_UNIX socket which will receive a file descriptor referencing the master end of the console's pseudoterminal. See docs/terminals.

--detach|-d

Detach from the container's process.

--pid-file path

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

--no-subreaper

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

--no-pivot

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.

--no-new-keyring

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

--preserve-fds N

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

--keep

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.

SEE ALSO

runc(8).