1ATOMIC(1)                          June 2016                         ATOMIC(1)
2
3
4

NAME

6       atomic-containers - operations on containers
7
8
9

SYNOPSIS

11       atomic containers COMMAND [OPTIONS] [CONTAINERS...]
12
13
14       atomic containers allows the user to view and operate on containers
15
16
17

COMMANDS

19       delete
20
21
22       delete specified container(s).
23
24
25       list
26
27
28       list containers on your system.
29
30
31       trim
32
33
34       discard unused blocks (fstrim) on running containers.
35
36
37       update
38
39
40       update a system container.
41
42
43       rollback
44
45
46       rollback a system container.
47
48
49

DESCRIPTION

51       atomic containers delete, delete specified container image from the
52       system.
53
54
55       Using --all will delete all the installed containers.
56
57
58       atomic containers list, by default, will list all running containers on
59       your system.
60
61
62       Using --all will list all the installed containers.
63
64
65       atomic containers trim, Discard unused blocks (fstrim) on rootfs of
66       running containers.
67
68
69       e.g. If you have 2 running containers on your system with container IDs
70       (496b8679b6cf, 9bb990da1203).
71
72
73              atomic containers trim Trimming container id 496b8679b6cf
74              Trimming container id 9bb990da1203
75
76
77       atomic containers update, update a system container to use a newer
78       version of an image.
79
80
81       Can use --set to update environment variables.
82
83
84       atomic containers rollback, rollback a system container to the other
85       deployment if one exists.
86
87
88

OPTIONS:

90       -h --help
91         Print usage statement
92
93
94

delete OPTIONS:

96       -a --all
97         Delete all the installed containers
98
99
100       -f --force
101         Force the deletion of specified running containers
102
103
104

list OPTIONS:

106       -a --all
107         Print all the installed containers
108
109
110       -f --filter
111         Filter output based on given filters, example usage: --filter
112       container=foo will list all containers that has "foo" as part of their
113       container ID.
114
115
116       Filterables: backend, command, container, created, image, runtime,
117       state
118
119
120       --json
121         Print in a machine parsable format
122
123
124       -n --noheading
125         Do not print heading when listing the containers
126
127
128       --no-trunc
129         Do not truncate output
130
131
132       -q --quiet
133         Only display container IDs
134
135
136

update OPTIONS:

138       --rebase=IMAGE
139         Rebase to a different image.  If not specified, the same image used
140       to install the container will be used.
141
142
143       -a --all
144         Update all the installed containers.  If any update fails, then it
145       rollbacks automatically to the working version of the container.
146
147
148       --set=NAME=VALUE
149         Set a value that is going to be used by a system container for its
150       configuration and can be specified multiple times.  OSTree is required
151       for this feature to be available.
152
153
154

HISTORY

156       June 2016, Originally compiled by Giuseppe Scrivano (gscrivan at redhat
157       dot com) July 2016, Added sub-commands filter, no-trunc and quiet
158       (jerzhang at redhat dot com) Sept 2016, Added atomic containers trim
159       subcommand (shishir dot mahajan at redhat dot com)
160
161
162
163Giuseppe Scrivano               Atomic Man Pages                     ATOMIC(1)