podman-image-exists(1) General Commands Manual podman-image-exists(1)

# [NAME](#NAME)

podman-image-exists - Check if an image exists in local storage

# [SYNOPSIS](#SYNOPSIS)

**podman image exists** *image*

# [DESCRIPTION](#DESCRIPTION)

**podman image exists** checks if an image exists in local storage. The **ID** or **Name** of the image may be used as input. Podman returns an exit code of **0** when the image is found. A **1** is returned otherwise. An exit code of **125** indicates there was an issue accessing the local storage.

# [OPTIONS](#OPTIONS)

## **--help**, **-h**

Print usage statement

# [EXAMPLES](#EXAMPLES)

Check if an image called **webclient** exists in local storage (the image does actually exist):

```
$ podman image exists webclient
$ echo $?
0
```

Check if an image called **webbackend** exists in local storage (the image does not actually exist):

```
$ podman image exists webbackend
$ echo $?
1
```

# [SEE ALSO](#SEE_ALSO)

[**podman(1)**](/man/os/podman/podman.1), [**podman-image(1)**](/man/os/podman/podman-image.1)

# [HISTORY](#HISTORY)

November 2018, Originally compiled by Brent Baude (bbaude at redhat dot com)

---

Document: podman-image-exists(1) from podman 6.0.0-r4 (Chainguard OS)