1runc-run(8) System Manager's Manual runc-run(8)
2
3
4
6 runc run - create and run a container
7
8
9
11 runc run [command options] <container-id>
12
13
14 Where "<container-id>" is your name for the instance of the container
15 that you are starting. The name you provide for the container instance
16 must be unique on your host.
17
18
19
21 The run command creates an instance of a container for a bundle. The
22 bundle is a directory with a specification file named "config.json" and
23 a root filesystem.
24
25
26 The specification file includes an args parameter. The args parameter
27 is used to specify command(s) that get run when the container is
28 started. To change the command(s) that get executed on start, edit the
29 args parameter of the spec. See "runc spec --help" for more explana‐
30 tion.
31
32
33
35 --bundle value, -b value path to the root of the bundle directory, defaults to the current directory
36 --console-socket value path to an AF_UNIX socket which will receive a file descriptor referencing the master end of the console's pseudoterminal
37 --detach, -d detach from the container's process
38 --pid-file value specify the file to write the process id to
39 --no-subreaper disable the use of the subreaper used to reap reparented processes
40 --no-pivot do not use pivot root to jail process inside rootfs. This should be used whenever the rootfs is on top of a ramdisk
41 --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
42 --preserve-fds value Pass N additional file descriptors to the container (stdio + $LISTEN_FDS + N in total) (default: 0)
43
44
45
46
47 runc-run(8)