Files
docker-cli/components/engine/docs/man/docker-search.1.md
Victor Vieux 676eea0fcd Revert "--help option and help command should print to stdout not stderr"
This reverts commit 61b129d81802e3c988cc0e67e488b24968dd748a.

Signed-off-by: Victor Vieux <vieux@docker.com>
Upstream-commit: 2e489073d94a7e2a5df115704a484c34f0b59f29
Component: engine
2014-08-27 18:59:13 +00:00

2.0 KiB

% DOCKER(1) Docker User Manuals % Docker Community % JUNE 2014

NAME

docker-search - Search the Docker Hub for images

SYNOPSIS

docker search [--automated[=false]] [--no-trunc[=false]] [-s|--stars[=0]] TERM

DESCRIPTION

Search an index for an image with that matches the term 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.

OPTIONS

--automated=true|false Only show automated builds. The default is false.

--no-trunc=true|false Don't truncate output. The default is false.

-s, --stars=0 Only displays with at least x stars

EXAMPLES

Search the registry for ranked images

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

$ sudo docker search -s 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 the registry for automated images

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

$ sudo docker search -s 1 -t 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]

HISTORY

April 2014, Originally compiled by William Henry (whenry at redhat dot com) based on docker.com source material and internal work. June 2014, updated by Sven Dowideit SvenDowideit@home.org.au