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

# docker-search(1)

Search Docker Hub for images

## NAME

docker-search - Search Docker Hub for images

## SYNOPSIS

**docker search \[OPTIONS\] TERM**

## 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 output based on these conditions:\
    \- stars=\
    \- is-automated=(true\|false) (deprecated)\
    \- is-official=(true\|false)

## EXAMPLES

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

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

**[docker(1)](/docker/1.md)**