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