github.com/opencontainers/runc@v1.2.0-rc.1.0.20240520010911-492dc558cdd6/man/runc-create.8.md (about)

     1  % runc-create "8"
     2  
     3  # NAME
     4  **runc-create** - create a container
     5  
     6  # SYNOPSIS
     7  **runc create** [_option_ ...] _container-id_
     8  
     9  # DESCRIPTION
    10  The **create** command creates an instance of a container from a bundle.
    11  The bundle is a directory with a specification file named _config.json_,
    12  and a root filesystem.
    13  
    14  # OPTIONS
    15  
    16  **--bundle**|**-b** _path_
    17  : Path to the root of the bundle directory. Default is current directory.
    18  
    19  **--console-socket** _path_
    20  : Path to an **AF_UNIX**  socket which will receive a file descriptor
    21  referencing the master end of the console's pseudoterminal.  See
    22  [docs/terminals](https://github.com/opencontainers/runc/blob/master/docs/terminals.md).
    23  
    24  **--pid-file** _path_
    25  : Specify the file to write the initial container process' PID to.
    26  
    27  **--no-pivot**
    28  : Do not use pivot root to jail process inside rootfs. This should not be used
    29  except in exceptional circumstances, and may be unsafe from the security
    30  standpoint.
    31  
    32  **--no-new-keyring**
    33  : Do not create a new session keyring for the container. This will cause the
    34  container to inherit the calling processes session key.
    35  
    36  **--preserve-fds** _N_
    37  : Pass _N_ additional file descriptors to the container (**stdio** +
    38  **$LISTEN_FDS** + _N_ in total). Default is **0**.
    39  
    40  # SEE ALSO
    41  
    42  **runc-spec**(8),
    43  **runc-start**(8),
    44  **runc**(8).