github.com/kobeld/docker@v1.12.0-rc1/docs/reference/commandline/search.md (about) 1 <!--[metadata]> 2 +++ 3 title = "search" 4 description = "The search command description and usage" 5 keywords = ["search, hub, images"] 6 [menu.main] 7 parent = "smn_cli" 8 +++ 9 <![end-metadata]--> 10 11 # search 12 13 Usage: docker search [OPTIONS] TERM 14 15 Search the Docker Hub for images 16 17 --filter=[] Filter output based on these conditions: 18 - is-automated=(true|false) 19 - is-official=(true|false) 20 - stars=<number> - image has at least 'number' stars 21 --help Print usage 22 --limit=25 Maximum returned search results 23 --no-trunc Don't truncate output 24 25 Search [Docker Hub](https://hub.docker.com) for images 26 27 See [*Find Public Images on Docker Hub*](../../tutorials/dockerrepos.md#searching-for-images) for 28 more details on finding shared images from the command line. 29 30 > **Note:** 31 > Search queries will only return up to 25 results 32 33 ## Examples 34 35 ### Search images by name 36 37 This example displays images with a name containing 'busybox': 38 39 $ docker search busybox 40 NAME DESCRIPTION STARS OFFICIAL AUTOMATED 41 busybox Busybox base image. 316 [OK] 42 progrium/busybox 50 [OK] 43 radial/busyboxplus Full-chain, Internet enabled, busybox made... 8 [OK] 44 odise/busybox-python 2 [OK] 45 azukiapp/busybox This image is meant to be used as the base... 2 [OK] 46 ofayau/busybox-jvm Prepare busybox to install a 32 bits JVM. 1 [OK] 47 shingonoide/archlinux-busybox Arch Linux, a lightweight and flexible Lin... 1 [OK] 48 odise/busybox-curl 1 [OK] 49 ofayau/busybox-libc32 Busybox with 32 bits (and 64 bits) libs 1 [OK] 50 peelsky/zulu-openjdk-busybox 1 [OK] 51 skomma/busybox-data Docker image suitable for data volume cont... 1 [OK] 52 elektritter/busybox-teamspeak Leightweight teamspeak3 container based on... 1 [OK] 53 socketplane/busybox 1 [OK] 54 oveits/docker-nginx-busybox This is a tiny NginX docker image based on... 0 [OK] 55 ggtools/busybox-ubuntu Busybox ubuntu version with extra goodies 0 [OK] 56 nikfoundas/busybox-confd Minimal busybox based distribution of confd 0 [OK] 57 openshift/busybox-http-app 0 [OK] 58 jllopis/busybox 0 [OK] 59 swyckoff/busybox 0 [OK] 60 powellquiring/busybox 0 [OK] 61 williamyeh/busybox-sh Docker image for BusyBox's sh 0 [OK] 62 simplexsys/busybox-cli-powered Docker busybox images, with a few often us... 0 [OK] 63 fhisamoto/busybox-java Busybox java 0 [OK] 64 scottabernethy/busybox 0 [OK] 65 marclop/busybox-solr 66 67 ### Display non-truncated description (--no-trunc) 68 69 This example displays images with a name containing 'busybox', 70 at least 3 stars and the description isn't truncated in the output: 71 72 $ docker search --stars=3 --no-trunc busybox 73 NAME DESCRIPTION STARS OFFICIAL AUTOMATED 74 busybox Busybox base image. 325 [OK] 75 progrium/busybox 50 [OK] 76 radial/busyboxplus Full-chain, Internet enabled, busybox made from scratch. Comes in git and cURL flavors. 8 [OK] 77 78 ## Limit search results (--limit) 79 80 The flag `--limit` is the maximium number of results returned by a search. This value could 81 be in the range between 1 and 100. The default value of `--limit` is 25. 82 83 84 ## Filtering 85 86 The filtering flag (`-f` or `--filter`) format is a `key=value` pair. If there is more 87 than one filter, then pass multiple flags (e.g. `--filter "foo=bar" --filter "bif=baz"`) 88 89 The currently supported filters are: 90 91 * stars (int - number of stars the image has) 92 * is-automated (true|false) - is the image automated or not 93 * is-official (true|false) - is the image official or not 94 95 96 ### stars 97 98 This example displays images with a name containing 'busybox' and at 99 least 3 stars: 100 101 $ docker search --filter stars=3 busybox 102 NAME DESCRIPTION STARS OFFICIAL AUTOMATED 103 busybox Busybox base image. 325 [OK] 104 progrium/busybox 50 [OK] 105 radial/busyboxplus Full-chain, Internet enabled, busybox made... 8 [OK] 106 107 108 ### is-automated 109 110 This example displays images with a name containing 'busybox' 111 and are automated builds: 112 113 $ docker search --filter is-automated busybox 114 NAME DESCRIPTION STARS OFFICIAL AUTOMATED 115 progrium/busybox 50 [OK] 116 radial/busyboxplus Full-chain, Internet enabled, busybox made... 8 [OK] 117 118 ### is-official 119 120 This example displays images with a name containing 'busybox', at least 121 3 stars and are official builds: 122 123 $ docker search --filter "is-automated=true" --filter "stars=3" busybox 124 NAME DESCRIPTION STARS OFFICIAL AUTOMATED 125 progrium/busybox 50 [OK] 126 radial/busyboxplus Full-chain, Internet enabled, busybox made... 8 [OK]