---
name: "docker-image-exists"
section: "1"
platform: "linux"
package: "podman-docker"
version: "6.1.4-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/podman-image-exists"
---

# docker-image-exists(1)

Check if an image exists in local storage

Part of [podman-image-exists(1)](/podman-image-exists/1.md).

## NAME

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

## SYNOPSIS

**podman image exists** *image*

## 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

### --help, -h

Print usage statement

## 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

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

## HISTORY

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