mirror of https://github.com/docker/docs.git
60 lines
2.1 KiB
YAML
60 lines
2.1 KiB
YAML
command: docker search
|
|
short: Search the Docker Hub for images
|
|
long: |
|
|
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]
|
|
usage: docker search [OPTIONS] TERM
|
|
pname: docker
|
|
plink: docker.yaml
|
|
options:
|
|
- option: automated
|
|
default_value: "false"
|
|
description: Only show automated builds
|
|
- option: filter
|
|
shorthand: f
|
|
description: Filter output based on conditions provided
|
|
- option: limit
|
|
default_value: "25"
|
|
description: Max number of search results
|
|
- option: no-trunc
|
|
default_value: "false"
|
|
description: Don't truncate output
|
|
- option: stars
|
|
shorthand: s
|
|
default_value: "0"
|
|
description: Only displays with at least x stars
|