1podman-container-exists(1)  General Commands Manual podman-container-exists(1)
2
3
4

NAME

6       podman-container-exists - Check if a container exists in local storage
7
8

SYNOPSIS

10       podman container exists [options] container
11
12

DESCRIPTION

14       podman  container exists checks if a container exists in local storage.
15       The container ID or name is used as input. Podman returns an exit  code
16       of  0  when the container is found.  A 1 is returned otherwise. An exit
17       code of 125 indicates there was an issue accessing the local storage.
18
19

OPTIONS

21   --external
22       Check for external containers as well as Podman containers.  These  ex‐
23       ternal  containers are generally created via other container technology
24       such as Buildah or CRI-O.
25       The default is false.
26
27
28       -h, --help
29
30
31       Prints usage statement.
32       The default is false.
33
34

EXAMPLES

36       Check if a container called "webclient" exists in local storage.  Here,
37       the container does exist.
38
39
40              $ podman container exists webclient
41              $ echo $?
42              0
43
44
45
46       Check if a container called "webbackend" exists in local storage. Here,
47       the container does not exist.
48
49
50              $ podman container exists webbackend
51              $ echo $?
52              1
53
54
55
56       Check if a container called "ubi8-working-container" created via  Buil‐
57       dah exists in local storage. Here, the container does not exist.
58
59
60              $ podman container exists --external ubi8-working-container
61              $ echo $?
62              1
63
64
65

SEE ALSO

67       podman(1)
68
69

HISTORY

71       November  2018,  Originally  compiled  by Brent Baude bbaude@redhat.com
72       ⟨mailto:bbaude@redhat.com⟩
73
74
75
76                                                    podman-container-exists(1)