docker-search - Man Page
Search Docker Hub for images
Examples (TL;DR)
- Search for Docker images by name or keyword:
docker search keyword
- Search for images and only show official ones:
docker search [-f|--filter] is-official=true keyword
- Search for images and only show automated builds:
docker search [-f|--filter] is-automated=true keyword
- Search for images with a minimum number of stars:
docker search [-f|--filter] stars=number keyword
- Limit the number of results:
docker search --limit number keyword
- Customize the output format:
docker search [-f|--format] ".Name: .Description" keyword
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
Info
May 2025 Docker Community Docker User Manuals