runc-run(8) System Manager's Manual runc-run(8)

# [NAME](#NAME)

**runc-run** - create and start a container

# [SYNOPSIS](#SYNOPSIS)

**runc run** \[*option* ...] *container-id*

# [DESCRIPTION](#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](#OPTIONS)

[**--bundle**|**-b** *path*](#bundle)

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

[**--console-socket** *path*](#console_socket)

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)

Detach from the container's process.

[**--pid-file** *path*](#pid_file)

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

[**--no-subreaper**](#no_subreaper)

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

[**--no-pivot**](#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**](#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*](#preserve_fds)

Pass *N* additional file descriptors to the container (**stdio** + **$LISTEN\_FDS** + *N* in total). Default is **0**.

[**--keep**](#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](#SEE_ALSO)

[**runc**(8)](/man/enterprise-packages/runc-fips/runc.8).

---

Document: runc-run(8) from runc-fips 1.5.2-r4 (Chainguard OS)
Source: https://github.com/opencontainers/runc