1ctr(1) General Commands Manual ctr(1)
2
3
4
6 ctr - command line for containerd
7
8
10 ctr [global options] command [command options] [arguments...]
11
12
14 ctr is an unsupported debug and administrative client for interacting
15 with the containerd daemon. Because it is unsupported, the commands,
16 options, and operation are not guaranteed to be backward compatible or
17 stable from release to release of the containerd project.
18
19
21 The following commands are available in the ctr utility:
22
23
24 plugins,plugin
25 Provides information about containerd plugins
26
27
28 version
29 Prints the client and server versions
30
31
32 containers,c,container
33 Manages and interacts with containers
34
35
36 content
37 Manages and interacts with content
38
39
40 events,event
41 Displays containerd events
42
43
44 images,image
45 Manages and interacts with images
46
47
48 namespaces,namespace
49 Manages and interacts with containerd namespaces
50
51
52 pprof Provides golang pprof outputs for containerd
53
54
55 run Runs a container
56
57
58 snapshots,snapshot
59 Manages and interacts with snapshots
60
61
62 tasks,t,task
63 Manages and interacts with tasks
64
65
66 shim Interacts with a containerd shim directly
67
68
69 help,h Displays a list of commands or help for one specific command
70
71
72 The following global options apply to all ctr commands:
73
74
75 --debug
76 Enable debug output in logs
77
78
79 --address value, -a value
80 Address for containerd's GRPC server (default: /run/contain‐
81 erd/containerd.sock)
82
83
84 --timeout value
85 Total timeout for ctr commands (default: 0s)
86
87
88 --connect-timeout value
89 Timeout for connecting to containerd (default: 0s)
90
91
92 --namespace value, -n value
93 Namespace to use with commands (default: default) [also read
94 from $CONTAINERD_NAMESPACE]
95
96
97 --help, -h
98 Show help text
99
100
101 --version, -v
102 Prints the ctr version
103
104
106 Note that the ctr utility is not an officially supported part of the
107 containerd project releases.
108
109
110 However, please feel free to file any specific issues that you
111 encounter at https://github.com/containerd/containerd.
112
113
115 Phil Estes estesp@gmail.com ⟨mailto:estesp@gmail.com⟩
116
117
119 containerd(1), containerd-config(1), containerd-config.toml(5)
120
121
122
123 01/30/2018 ctr(1)