.TH "DOCKER" "1" "Feb 2021" "Docker Community" "" 
.nh
.ad l


.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 \fB\fCTERM\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=<numberOfStar>
   \- 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:

.PP
.RS

.nf
$ 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]

.fi
.RE

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

.PP
.RS

.nf
$ 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]

.fi
.RE


.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