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
              ⟨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.

SEE ALSO

       runc(8).

                                                                                      runc-run(8)