github.com/vieux/docker@v0.6.3-0.20161004191708-e097c2a938c7/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  [**-f**|**--filter**[=*[]*]]
    10  [**--help**]
    11  [**--limit**[=*LIMIT*]]
    12  [**--no-trunc**]
    13  TERM
    14  
    15  # DESCRIPTION
    16  
    17  Search Docker Hub for images that match the specified `TERM`. The table
    18  of images returned displays the name, description (truncated by default), number
    19  of stars awarded, whether the image is official, and whether it is automated.
    20  
    21  *Note* - Search queries will only return up to 25 results
    22  
    23  # OPTIONS
    24  
    25  **-f**, **--filter**=[]
    26     Filter output based on these conditions:
    27     - stars=<numberOfStar>
    28     - is-automated=(true|false)
    29     - is-official=(true|false)
    30  
    31  **--help**
    32    Print usage statement
    33  
    34  **--limit**=*LIMIT*
    35    Maximum returned search results. The default is 25.
    36  
    37  **--no-trunc**=*true*|*false*
    38     Don't truncate output. The default is *false*.
    39  
    40  # EXAMPLES
    41  
    42  ## Search Docker Hub for ranked images
    43  
    44  Search a registry for the term 'fedora' and only display those images
    45  ranked 3 or higher:
    46  
    47      $ docker search --filter=stars=3 fedora
    48      NAME                  DESCRIPTION                                    STARS OFFICIAL  AUTOMATED
    49      mattdm/fedora         A basic Fedora image corresponding roughly...  50
    50      fedora                (Semi) Official Fedora base image.             38
    51      mattdm/fedora-small   A small Fedora image on which to build. Co...  8
    52      goldmann/wildfly      A WildFly application server running on a ...  3               [OK]
    53  
    54  ## Search Docker Hub for automated images
    55  
    56  Search Docker Hub for the term 'fedora' and only display automated images
    57  ranked 1 or higher:
    58  
    59      $ docker search --filter=is-automated=true --filter=stars=1 fedora
    60      NAME               DESCRIPTION                                     STARS OFFICIAL  AUTOMATED
    61      goldmann/wildfly   A WildFly application server running on a ...   3               [OK]
    62      tutum/fedora-20    Fedora 20 image with SSH access. For the r...   1               [OK]
    63  
    64  # HISTORY
    65  April 2014, Originally compiled by William Henry (whenry at redhat dot com)
    66  based on docker.com source material and internal work.
    67  June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
    68  April 2015, updated by Mary Anthony for v2 <mary@docker.com>
    69  April 2016, updated by Vincent Demeester <vincent@sbr.pm>
    70