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.
-
--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
⟨https://github.com/opencontainers/runc/blob/master/docs/terminals.md⟩.
-
--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.
runc(8).