mirror of https://github.com/docker/docs.git
91 lines
6.7 KiB
YAML
91 lines
6.7 KiB
YAML
command: docker search
|
|
short: Search the Docker Hub for images
|
|
long: |-
|
|
Search [Docker Hub](https://hub.docker.com) for images
|
|
|
|
See [*Find Public Images on Docker Hub*](https://docs.docker.com/engine/tutorials/dockerrepos/#searching-for-images) for
|
|
more details on finding shared images from the command line.
|
|
|
|
> **Note**: Search queries return a maximum of 25 results.
|
|
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
|
|
examples: "### Search images by name\n\nThis example displays images with a name containing
|
|
'busybox':\n\n```none\n$ docker search busybox\n\nNAME DESCRIPTION
|
|
\ STARS OFFICIAL AUTOMATED\nbusybox Busybox
|
|
base image. 316 [OK] \nprogrium/busybox
|
|
\ 50 [OK]\nradial/busyboxplus
|
|
\ Full-chain, Internet enabled, busybox made... 8 [OK]\nodise/busybox-python
|
|
\ 2 [OK]\nazukiapp/busybox
|
|
\ This image is meant to be used as the base... 2 [OK]\nofayau/busybox-jvm
|
|
\ Prepare busybox to install a 32 bits JVM. 1 [OK]\nshingonoide/archlinux-busybox
|
|
\ Arch Linux, a lightweight and flexible Lin... 1 [OK]\nodise/busybox-curl
|
|
\ 1 [OK]\nofayau/busybox-libc32
|
|
\ Busybox with 32 bits (and 64 bits) libs 1 [OK]\npeelsky/zulu-openjdk-busybox
|
|
\ 1 [OK]\nskomma/busybox-data
|
|
\ Docker image suitable for data volume cont... 1 [OK]\nelektritter/busybox-teamspeak
|
|
\ Lightweight teamspeak3 container based on... 1 [OK]\nsocketplane/busybox
|
|
\ 1 [OK]\noveits/docker-nginx-busybox
|
|
\ This is a tiny NginX docker image based on... 0 [OK]\nggtools/busybox-ubuntu
|
|
\ Busybox ubuntu version with extra goodies 0 [OK]\nnikfoundas/busybox-confd
|
|
\ Minimal busybox based distribution of confd 0 [OK]\nopenshift/busybox-http-app
|
|
\ 0 [OK]\njllopis/busybox
|
|
\ 0 [OK]\nswyckoff/busybox
|
|
\ 0 [OK]\npowellquiring/busybox
|
|
\ 0 [OK]\nwilliamyeh/busybox-sh
|
|
\ Docker image for BusyBox's sh 0 [OK]\nsimplexsys/busybox-cli-powered
|
|
\ Docker busybox images, with a few often us... 0 [OK]\nfhisamoto/busybox-java
|
|
\ Busybox java 0 [OK]\nscottabernethy/busybox
|
|
\ 0 [OK]\nmarclop/busybox-solr\n```\n\n###
|
|
Display non-truncated description (--no-trunc)\n\nThis example displays images with
|
|
a name containing 'busybox',\nat least 3 stars and the description isn't truncated
|
|
in the output:\n\n```bash\n$ docker search --stars=3 --no-trunc busybox\nNAME DESCRIPTION
|
|
\ STARS
|
|
\ OFFICIAL AUTOMATED\nbusybox Busybox base image. 325
|
|
\ [OK] \nprogrium/busybox 50
|
|
\ [OK]\nradial/busyboxplus Full-chain, Internet enabled, busybox
|
|
made from scratch. Comes in git and cURL flavors. 8 [OK]\n```\n\n###
|
|
Limit search results (--limit)\n\nThe flag `--limit` is the maximum number of results
|
|
returned by a search. This value could\nbe in the range between 1 and 100. The default
|
|
value of `--limit` is 25.\n\n### Filtering\n\nThe filtering flag (`-f` or `--filter`)
|
|
format is a `key=value` pair. If there is more\nthan one filter, then pass multiple
|
|
flags (e.g. `--filter \"foo=bar\" --filter \"bif=baz\"`)\n\nThe currently supported
|
|
filters are:\n\n* stars (int - number of stars the image has)\n* is-automated (boolean
|
|
- true or false) - is the image automated or not\n* is-official (boolean - true
|
|
or false) - is the image official or not\n\n#### stars\n\nThis example displays
|
|
images with a name containing 'busybox' and at\nleast 3 stars:\n\n```bash\n$ docker
|
|
search --filter stars=3 busybox\n\nNAME DESCRIPTION STARS
|
|
\ OFFICIAL AUTOMATED\nbusybox Busybox base image. 325
|
|
\ [OK] \nprogrium/busybox 50
|
|
\ [OK]\nradial/busyboxplus Full-chain, Internet enabled, busybox
|
|
made... 8 [OK]\n```\n\n#### is-automated\n\nThis example displays
|
|
images with a name containing 'busybox'\nand are automated builds:\n\n```bash\n$
|
|
docker search --filter is-automated busybox\n\nNAME DESCRIPTION
|
|
\ STARS OFFICIAL AUTOMATED\nprogrium/busybox
|
|
\ 50 [OK]\nradial/busyboxplus
|
|
\ Full-chain, Internet enabled, busybox made... 8 [OK]\n```\n\n####
|
|
is-official\n\nThis example displays images with a name containing 'busybox', at
|
|
least\n3 stars and are official builds:\n\n```bash\n$ docker search --filter \"is-official=true\"
|
|
--filter \"stars=3\" busybox\n\nNAME DESCRIPTION STARS
|
|
\ OFFICIAL AUTOMATED\nprogrium/busybox 50
|
|
\ [OK]\nradial/busyboxplus Full-chain, Internet enabled, busybox
|
|
made... 8 [OK]\n```"
|
|
|