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

# [NAME](#NAME)

**runc-create** - create a container

# [SYNOPSIS](#SYNOPSIS)

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

# [DESCRIPTION](#DESCRIPTION)

The **create** command creates an instance of a container from a bundle. The bundle is a directory with a specification file named *config.json*, and a root filesystem.

# [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⟩.

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

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

[**--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**.

# [SEE ALSO](#SEE_ALSO)

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

---

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