DOCKER(1) Docker User Manuals DOCKER(1)

# [NAME](#NAME)

docker-search - Search Docker Hub for images

# [SYNOPSIS](#SYNOPSIS)

**docker search \[OPTIONS] TERM**

# [DESCRIPTION](#DESCRIPTION)

Search Docker Hub for images that match the specified **TERM**. The table of images returned displays the name, description (truncated by default), number of stars awarded, whether the image is official, and whether it is automated.

# [Filter](#Filter)

Filter output based on these conditions:  
\- stars=  
\- is-automated=(true|false) (deprecated)  
\- is-official=(true|false)

# [EXAMPLES](#EXAMPLES)

# [Search Docker Hub for ranked images](#Search_Docker_Hub_for_ranked_images)

Search a registry for the term 'fedora' and only display those images ranked 3 or higher:

```
$ docker search --filter=stars=3 fedora
NAME      DESCRIPTION                        STARS     OFFICIAL
fedora    Official Docker builds of Fedora   1150      [OK]
```

# [OPTIONS](#OPTIONS)

**-f**, **--filter**= Filter output based on conditions provided

**--format**="" Pretty-print search using a Go template

**--limit**=0 Max number of search results

**--no-trunc**\[=false] Don't truncate output

# [SEE ALSO](#SEE_ALSO)

[**docker(1)**](/man/os/docker-cli/docker.1)

Oct 2026 Docker Community

---

Document: docker-search(1) from docker-cli 29.9.1-r0 (Chainguard OS)
Source: https://github.com/docker/cli