1DOCKER(1)                          JUNE 2014                         DOCKER(1)
2
3
4

NAME

6       docker-search - Search the Docker Hub for images
7
8
9

SYNOPSIS

11       docker search [-f|--filter[=[]]] [--help] [--limit[=LIMIT]]
12       [--no-index] [--no-trunc] TERM
13
14
15

DESCRIPTION

17       Search Docker Hub for images that match the specified TERM. The table
18       of images returned displays the name, description (truncated by
19       default), number of stars awarded, whether the image is official, and
20       whether it is automated.
21
22
23       Note - Search queries will only return up to 25 results
24
25
26

OPTIONS

28       -f, --filter=[]
29          Filter output based on these conditions:
30          - stars=<numberOfStar>
31          - is-automated=(true|false)
32          - is-official=(true|false)
33
34
35       --help
36          Print usage statement
37
38
39       --no-index=true|false
40          Do not include index name in output. Sort results primarily by
41       registry
42          name.
43
44
45       --limit=LIMIT
46         Maximum returned search results. The default is 25.
47
48
49       --no-trunc=true|false
50          Don't truncate output. The default is false.
51
52
53

EXAMPLES

Search Docker Hub for ranked images

56       Search a registry for the term 'fedora' and only display those images
57       ranked 3 or higher:
58
59
60              $ docker search --filter=starts=3 fedora
61              INDEX      NAME                            DESCRIPTION                                    STARS OFFICIAL  AUTOMATED
62              docker.io  docker.io/mattdm/fedora         A basic Fedora image corresponding roughly...  50
63              docker.io  docker.io/fedora                (Semi) Official Fedora base image.             38
64              docker.io  docker.io/mattdm/fedora-small   A small Fedora image on which to build. Co...  8
65              docker.io  docker.io/goldmann/wildfly      A WildFly application server running on a ...  3               [OK]
66
67
68

Search Docker Hub for automated images

70       Search Docker Hub for the term 'fedora' and only display automated
71       images ranked 1 or higher:
72
73
74              $ docker search --filter=is-automated=true --filter=starts=1 fedora
75              INDEX      NAME                         DESCRIPTION                                     STARS OFFICIAL  AUTOMATED
76              docker.io  docker.io/goldmann/wildfly   A WildFly application server running on a ...   3               [OK]
77              docker.io  docker.io/tutum/fedora-20    Fedora 20 image with SSH access. For the r...   1               [OK]
78
79
80
81

HISTORY

83       April 2014, Originally compiled by William Henry (whenry at redhat dot
84       com) based on docker.com source material and internal work.  June 2014,
85       updated by Sven Dowideit ⟨SvenDowideit@home.org.au⟩ April 2015, updated
86       by Mary Anthony for v2 ⟨mary@docker.com⟩ April 2016, updated by Vincent
87       Demeester ⟨vincent@sbr.pm⟩
88
89
90
91Docker Community              Docker User Manuals                    DOCKER(1)
Impressum