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

SEE ALSO

64       podman(1)
65
66

HISTORY

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