.nh
.TH "DOCKER" "1" "Jan 2024" "Docker Community" "Docker User Manuals"

.SH NAME
.PP
docker-search - Search the Docker Hub for images


.SH SYNOPSIS
.PP
\fBdocker search [OPTIONS] TERM\fP


.SH DESCRIPTION
.PP
Search Docker Hub for images that match the specified \fBTERM\fR\&. 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.

.PP
\fINote\fP - Search queries will only return up to 25 results

.SH Filter
.PP
Filter output based on these conditions:
   - stars=
   - is-automated=(true|false)
   - is-official=(true|false)


.SH EXAMPLES
.SH Search Docker Hub for ranked images
.PP
Search a registry for the term 'fedora' and only display those images
ranked 3 or higher:

.EX
$ docker search --filter=stars=3 fedora
NAME                  DESCRIPTION                                    STARS OFFICIAL  AUTOMATED
mattdm/fedora         A basic Fedora image corresponding roughly...  50
fedora                (Semi) Official Fedora base image.             38
mattdm/fedora-small   A small Fedora image on which to build. Co...  8
goldmann/wildfly      A WildFly application server running on a ...  3               [OK]

.EE

.SH Search Docker Hub for automated images
.PP
Search Docker Hub for the term 'fedora' and only display automated images
ranked 1 or higher:

.EX
$ docker search --filter=is-automated=true --filter=stars=1 fedora
NAME               DESCRIPTION                                     STARS OFFICIAL  AUTOMATED
goldmann/wildfly   A WildFly application server running on a ...   3               [OK]
tutum/fedora-20    Fedora 20 image with SSH access. For the r...   1               [OK]

.EE


.SH OPTIONS
.PP
\fB-f\fP, \fB--filter\fP=
	Filter output based on conditions provided

.PP
\fB--format\fP=""
	Pretty-print search using a Go template

.PP
\fB-h\fP, \fB--help\fP[=false]
	help for search

.PP
\fB--limit\fP=25
	Max number of search results

.PP
\fB--no-trunc\fP[=false]
	Don't truncate output


.SH SEE ALSO
.PP
\fBdocker(1)\fP