1runc-run(8) System Manager's Manual runc-run(8)
2
3
4
6 runc-run - create and start a container
7
8
9
11 runc run [option ...] container-id
12
13
14
16 The run command creates an instance of a container from a bundle, and
17 starts it. You can think of run as a shortcut for create followed by
18 start.
19
20
21
23 --bundle|-b path
24 Path to the root of the bundle directory. Default is current di‐
25 rectory.
26
27
28 --console-socket path
29 Path to an AF_UNIX socket which will receive a file descriptor
30 referencing the master end of the console's pseudoterminal. See
31 docs/terminals ⟨https://github.com/opencontainers/runc/blob/mas‐
32 ter/docs/terminals.md⟩.
33
34
35 --detach|-d
36 Detach from the container's process.
37
38
39 --pid-file path
40 Specify the file to write the initial container process' PID to.
41
42
43 --no-subreaper
44 Disable the use of the subreaper used to reap reparented pro‐
45 cesses.
46
47
48 --no-pivot
49 Do not use pivot root to jail process inside rootfs. This should
50 not be used except in exceptional circumstances, and may be un‐
51 safe from the security standpoint.
52
53
54 --no-new-keyring
55 Do not create a new session keyring for the container. This will
56 cause the container to inherit the calling processes session
57 key.
58
59
60 --preserve-fds N
61 Pass N additional file descriptors to the container (stdio +
62 $LISTEN_FDS + N in total). Default is 0.
63
64
65 --keep Keep container's state directory and cgroup. This can be helpful
66 if a user wants to check the state (e.g. of cgroup controllers)
67 after the container has exited. If this option is used, a manual
68 runc delete is needed afterwards to clean an exited container's
69 artefacts.
70
71
72
74 runc(8).
75
76
77
78 runc-run(8)