github.com/fcwu/docker@v1.4.2-0.20150115145920-2a69ca89f0df/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  # OPTIONS
    23  **--automated**=*true*|*false*
    24     Only show automated builds. The default is *false*.
    25  
    26  **--help**
    27    Print usage statement
    28  
    29  **--no-trunc**=*true*|*false*
    30     Don't truncate output. The default is *false*.
    31  
    32  **-s**, **--stars**=0
    33     Only displays with at least x stars
    34  
    35  # EXAMPLES
    36  
    37  ## Search the registry for ranked images
    38  
    39  Search the registry for the term 'fedora' and only display those images
    40  ranked 3 or higher:
    41  
    42      $ sudo docker search -s 3 fedora
    43      NAME                  DESCRIPTION                                    STARS OFFICIAL  AUTOMATED
    44      mattdm/fedora         A basic Fedora image corresponding roughly...  50
    45      fedora                (Semi) Official Fedora base image.             38
    46      mattdm/fedora-small   A small Fedora image on which to build. Co...  8
    47      goldmann/wildfly      A WildFly application server running on a ...  3               [OK]
    48  
    49  ## Search the registry for automated images
    50  
    51  Search the registry for the term 'fedora' and only display automated images
    52  ranked 1 or higher:
    53  
    54      $ sudo docker search -s 1 -t fedora
    55      NAME               DESCRIPTION                                     STARS OFFICIAL  AUTOMATED
    56      goldmann/wildfly   A WildFly application server running on a ...   3               [OK]
    57      tutum/fedora-20    Fedora 20 image with SSH access. For the r...   1               [OK]
    58  
    59  # HISTORY
    60  April 2014, Originally compiled by William Henry (whenry at redhat dot com)
    61  based on docker.com source material and internal work.
    62  June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>