Provided by: docker.io_17.12.1-0ubuntu1_amd64 bug

NAME

       docker-search - Search the Docker Hub for images

SYNOPSIS

       docker search [OPTIONS] TERM

DESCRIPTION

       Search Docker Hub for images that match the specified TERM. The table of images returned
       displays the name, description (truncated by default), number of stars awarded, whether
       the image is official, and whether it is automated.

       Note - Search queries will only return up to 25 results

Filter

       Filter output based on these conditions:
          - stars=<numberOfStar>
          - is-automated=(true|false)
          - is-official=(true|false)

EXAMPLES

Search Docker Hub for ranked images

       Search a registry for the term 'fedora' and only display those images ranked 3 or higher:

              $ docker search --filter=stars=3 fedora
              NAME                  DESCRIPTION                                    STARS OFFICIAL  AUTOMATED
              mattdm/fedora         A basic Fedora image corresponding roughly...  50
              fedora                (Semi) Official Fedora base image.             38
              mattdm/fedora-small   A small Fedora image on which to build. Co...  8
              goldmann/wildfly      A WildFly application server running on a ...  3               [OK]

Search Docker Hub for automated images

       Search Docker Hub for the term 'fedora' and only display automated images ranked 1 or
       higher:

              $ docker search --filter=is-automated=true --filter=stars=1 fedora
              NAME               DESCRIPTION                                     STARS OFFICIAL  AUTOMATED
              goldmann/wildfly   A WildFly application server running on a ...   3               [OK]
              tutum/fedora-20    Fedora 20 image with SSH access. For the r...   1               [OK]

OPTIONS

       -f, --filter=
           Filter output based on conditions provided

       --format=""
           Pretty-print search using a Go template

       -h, --help[=false]
           help for search

       --limit=25
           Max number of search results

       --no-trunc[=false]
           Don't truncate output

SEE ALSO

       docker(1)