.nh
.TH runc-run "8"

.SH NAME
.PP
\fBrunc-run\fP - create and start a container


.SH SYNOPSIS
.PP
\fBrunc run\fP [\fIoption\fP ...] \fIcontainer-id\fP


.SH DESCRIPTION
.PP
The \fBrun\fP command creates an instance of a container from a bundle, and
starts it.  You can think of \fBrun\fP as a shortcut for \fBcreate\fP followed by
\fBstart\fP\&.


.SH OPTIONS
.TP
\fB--bundle\fP|\fB-b\fP \fIpath\fP
Path to the root of the bundle directory. Default is current directory.

.TP
\fB--console-socket\fP \fIpath\fP
Path to an \fBAF_UNIX\fP  socket which will receive a file descriptor
referencing the master end of the console's pseudoterminal.  See
docs/terminals
\[la]https://github.com/opencontainers/runc/blob/master/docs/terminals.md\[ra]\&.

.TP
\fB--detach\fP|\fB-d\fP
Detach from the container's process.

.TP
\fB--pid-file\fP \fIpath\fP
Specify the file to write the initial container process' PID to.

.TP
\fB--no-subreaper\fP
Disable the use of the subreaper used to reap reparented processes.

.TP
\fB--no-pivot\fP
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.

.TP
\fB--no-new-keyring\fP
Do not create a new session keyring for the container. This will cause the
container to inherit the calling processes session key.

.TP
\fB--preserve-fds\fP \fIN\fP
Pass \fIN\fP additional file descriptors to the container (\fBstdio\fP +
\fB$LISTEN_FDS\fP + \fIN\fP in total). Default is \fB0\fP\&.

.TP
\fB--keep\fP
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 \fBrunc delete\fP is needed afterwards
to clean an exited container's artefacts.


.SH SEE ALSO
.PP
\fBrunc\fP(8).