github.com/daaku/docker@v1.5.0/docs/man/docker-search.1.md (about)

     1  % DOCKER(1) Docker User Manuals
     2  % Docker Community
     3  % JUNE 2014
     4  # NAME
     5  docker-search - Search the Docker Hub for images
     6  
     7  # SYNOPSIS
     8  **docker search**
     9  [**--automated**[=*false*]]
    10  [**--help**]
    11  [**--no-trunc**[=*false*]]
    12  [**-s**|**--stars**[=*0*]]
    13  TERM
    14  
    15  # DESCRIPTION
    16  
    17  Search an index for an image with that matches the term TERM. The table
    18  of images returned displays the name, description (truncated by default),
    19  number of stars awarded, whether the image is official, and whether it
    20  is automated.
    21  
    22  *Note* - Search queries will only return up to 25 results
    23  
    24  # OPTIONS
    25  **--automated**=*true*|*false*
    26     Only show automated builds. The default is *false*.
    27  
    28  **--help**
    29    Print usage statement
    30  
    31  **--no-trunc**=*true*|*false*
    32     Don't truncate output. The default is *false*.
    33  
    34  **-s**, **--stars**=0
    35     Only displays with at least x stars
    36  
    37  # EXAMPLES
    38  
    39  ## Search the registry for ranked images
    40  
    41  Search the registry for the term 'fedora' and only display those images
    42  ranked 3 or higher:
    43  
    44      $ sudo docker search -s 3 fedora
    45      NAME                  DESCRIPTION                                    STARS OFFICIAL  AUTOMATED
    46      mattdm/fedora         A basic Fedora image corresponding roughly...  50
    47      fedora                (Semi) Official Fedora base image.             38
    48      mattdm/fedora-small   A small Fedora image on which to build. Co...  8
    49      goldmann/wildfly      A WildFly application server running on a ...  3               [OK]
    50  
    51  ## Search the registry for automated images
    52  
    53  Search the registry for the term 'fedora' and only display automated images
    54  ranked 1 or higher:
    55  
    56      $ sudo docker search -s 1 -t fedora
    57      NAME               DESCRIPTION                                     STARS OFFICIAL  AUTOMATED
    58      goldmann/wildfly   A WildFly application server running on a ...   3               [OK]
    59      tutum/fedora-20    Fedora 20 image with SSH access. For the r...   1               [OK]
    60  
    61  # HISTORY
    62  April 2014, Originally compiled by William Henry (whenry at redhat dot com)
    63  based on docker.com source material and internal work.
    64  June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>