github.com/shopify/docker@v1.13.1/docs/deprecated.md (about) 1 --- 2 aliases: ["/engine/misc/deprecated/"] 3 title: "Deprecated Engine Features" 4 description: "Deprecated Features." 5 keywords: "docker, documentation, about, technology, deprecate" 6 --- 7 8 <!-- This file is maintained within the docker/docker Github 9 repository at https://github.com/docker/docker/. Make all 10 pull requests against that repo. If you see this file in 11 another repository, consider it read-only there, as it will 12 periodically be overwritten by the definitive file. Pull 13 requests which include edits to this file in other repositories 14 will be rejected. 15 --> 16 17 # Deprecated Engine Features 18 19 The following list of features are deprecated in Engine. 20 To learn more about Docker Engine's deprecation policy, 21 see [Feature Deprecation Policy](https://docs.docker.com/engine/#feature-deprecation-policy). 22 23 24 ### Top-level network properties in NetworkSettings 25 26 **Deprecated In Release: v1.13.0** 27 28 **Target For Removal In Release: v1.16** 29 30 When inspecting a container, `NetworkSettings` contains top-level information 31 about the default ("bridge") network; 32 33 `EndpointID`, `Gateway`, `GlobalIPv6Address`, `GlobalIPv6PrefixLen`, `IPAddress`, 34 `IPPrefixLen`, `IPv6Gateway`, and `MacAddress`. 35 36 These properties are deprecated in favor of per-network properties in 37 `NetworkSettings.Networks`. These properties were already "deprecated" in 38 docker 1.9, but kept around for backward compatibility. 39 40 Refer to [#17538](https://github.com/docker/docker/pull/17538) for further 41 information. 42 43 ## `filter` param for `/images/json` endpoint 44 **Deprecated In Release: [v1.13.0](https://github.com/docker/docker/releases/tag/v1.13.0)** 45 46 **Target For Removal In Release: v1.16** 47 48 The `filter` param to filter the list of image by reference (name or name:tag) is now implemented as a regular filter, named `reference`. 49 50 ### `repository:shortid` image references 51 **Deprecated In Release: [v1.13.0](https://github.com/docker/docker/releases/tag/v1.13.0)** 52 53 **Target For Removal In Release: v1.16** 54 55 `repository:shortid` syntax for referencing images is very little used, collides with tag references can be confused with digest references. 56 57 ### `docker daemon` subcommand 58 **Deprecated In Release: [v1.13.0](https://github.com/docker/docker/releases/tag/v1.13.0)** 59 60 **Target For Removal In Release: v1.16** 61 62 The daemon is moved to a separate binary (`dockerd`), and should be used instead. 63 64 ### Duplicate keys with conflicting values in engine labels 65 **Deprecated In Release: [v1.13.0](https://github.com/docker/docker/releases/tag/v1.13.0)** 66 67 **Target For Removal In Release: v1.16** 68 69 Duplicate keys with conflicting values have been deprecated. A warning is displayed 70 in the output, and an error will be returned in the future. 71 72 ### `MAINTAINER` in Dockerfile 73 **Deprecated In Release: [v1.13.0](https://github.com/docker/docker/releases/tag/v1.13.0)** 74 75 `MAINTAINER` was an early very limited form of `LABEL` which should be used instead. 76 77 ### API calls without a version 78 **Deprecated In Release: [v1.13.0](https://github.com/docker/docker/releases/tag/v1.13.0)** 79 80 **Target For Removal In Release: v1.16** 81 82 API versions should be supplied to all API calls to ensure compatibility with 83 future Engine versions. Instead of just requesting, for example, the URL 84 `/containers/json`, you must now request `/v1.25/containers/json`. 85 86 ### Backing filesystem without `d_type` support for overlay/overlay2 87 **Deprecated In Release: [v1.13.0](https://github.com/docker/docker/releases/tag/v1.13.0)** 88 89 **Target For Removal In Release: v1.16** 90 91 The overlay and overlay2 storage driver does not work as expected if the backing 92 filesystem does not support `d_type`. For example, XFS does not support `d_type` 93 if it is formatted with the `ftype=0` option. 94 95 Please also refer to [#27358](https://github.com/docker/docker/issues/27358) for 96 further information. 97 98 ### Three arguments form in `docker import` 99 **Deprecated In Release: [v0.6.7](https://github.com/docker/docker/releases/tag/v0.6.7)** 100 101 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 102 103 The `docker import` command format `file|URL|- [REPOSITORY [TAG]]` is deprecated since November 2013. It's no more supported. 104 105 ### `-h` shorthand for `--help` 106 107 **Deprecated In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 108 109 **Target For Removal In Release: v1.15** 110 111 The shorthand (`-h`) is less common than `--help` on Linux and cannot be used 112 on all subcommands (due to it conflicting with, e.g. `-h` / `--hostname` on 113 `docker create`). For this reason, the `-h` shorthand was not printed in the 114 "usage" output of subcommands, nor documented, and is now marked "deprecated". 115 116 ### `-e` and `--email` flags on `docker login` 117 **Deprecated In Release: [v1.11.0](https://github.com/docker/docker/releases/tag/v1.11.0)** 118 119 **Target For Removal In Release: v1.14** 120 121 The docker login command is removing the ability to automatically register for an account with the target registry if the given username doesn't exist. Due to this change, the email flag is no longer required, and will be deprecated. 122 123 ### Separator (`:`) of `--security-opt` flag on `docker run` 124 **Deprecated In Release: [v1.11.0](https://github.com/docker/docker/releases/tag/v1.11.0)** 125 126 **Target For Removal In Release: v1.14** 127 128 The flag `--security-opt` doesn't use the colon separator(`:`) anymore to divide keys and values, it uses the equal symbol(`=`) for consistency with other similar flags, like `--storage-opt`. 129 130 ### `/containers/(id or name)/copy` endpoint 131 132 **Deprecated In Release: [v1.8.0](https://github.com/docker/docker/releases/tag/v1.8.0)** 133 134 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 135 136 The endpoint `/containers/(id or name)/copy` is deprecated in favor of `/containers/(id or name)/archive`. 137 138 ### Ambiguous event fields in API 139 **Deprecated In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 140 141 The fields `ID`, `Status` and `From` in the events API have been deprecated in favor of a more rich structure. 142 See the events API documentation for the new format. 143 144 ### `-f` flag on `docker tag` 145 **Deprecated In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 146 147 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 148 149 To make tagging consistent across the various `docker` commands, the `-f` flag on the `docker tag` command is deprecated. It is not longer necessary to specify `-f` to move a tag from one image to another. Nor will `docker` generate an error if the `-f` flag is missing and the specified tag is already in use. 150 151 ### HostConfig at API container start 152 **Deprecated In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 153 154 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 155 156 Passing an `HostConfig` to `POST /containers/{name}/start` is deprecated in favor of 157 defining it at container creation (`POST /containers/create`). 158 159 ### `--before` and `--since` flags on `docker ps` 160 161 **Deprecated In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 162 163 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 164 165 The `docker ps --before` and `docker ps --since` options are deprecated. 166 Use `docker ps --filter=before=...` and `docker ps --filter=since=...` instead. 167 168 ### `--automated` and `--stars` flags on `docker search` 169 170 **Deprecated in Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 171 172 **Target For Removal In Release: v1.15** 173 174 The `docker search --automated` and `docker search --stars` options are deprecated. 175 Use `docker search --filter=is-automated=...` and `docker search --filter=stars=...` instead. 176 177 ### Driver Specific Log Tags 178 **Deprecated In Release: [v1.9.0](https://github.com/docker/docker/releases/tag/v1.9.0)** 179 180 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 181 182 Log tags are now generated in a standard way across different logging drivers. 183 Because of which, the driver specific log tag options `syslog-tag`, `gelf-tag` and 184 `fluentd-tag` have been deprecated in favor of the generic `tag` option. 185 186 docker --log-driver=syslog --log-opt tag="{{.ImageName}}/{{.Name}}/{{.ID}}" 187 188 ### LXC built-in exec driver 189 **Deprecated In Release: [v1.8.0](https://github.com/docker/docker/releases/tag/v1.8.0)** 190 191 **Removed In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 192 193 The built-in LXC execution driver, the lxc-conf flag, and API fields have been removed. 194 195 ### Old Command Line Options 196 **Deprecated In Release: [v1.8.0](https://github.com/docker/docker/releases/tag/v1.8.0)** 197 198 **Removed In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 199 200 The flags `-d` and `--daemon` are deprecated in favor of the `daemon` subcommand: 201 202 docker daemon -H ... 203 204 The following single-dash (`-opt`) variant of certain command line options 205 are deprecated and replaced with double-dash options (`--opt`): 206 207 docker attach -nostdin 208 docker attach -sig-proxy 209 docker build -no-cache 210 docker build -rm 211 docker commit -author 212 docker commit -run 213 docker events -since 214 docker history -notrunc 215 docker images -notrunc 216 docker inspect -format 217 docker ps -beforeId 218 docker ps -notrunc 219 docker ps -sinceId 220 docker rm -link 221 docker run -cidfile 222 docker run -dns 223 docker run -entrypoint 224 docker run -expose 225 docker run -link 226 docker run -lxc-conf 227 docker run -n 228 docker run -privileged 229 docker run -volumes-from 230 docker search -notrunc 231 docker search -stars 232 docker search -t 233 docker search -trusted 234 docker tag -force 235 236 The following double-dash options are deprecated and have no replacement: 237 238 docker run --cpuset 239 docker run --networking 240 docker ps --since-id 241 docker ps --before-id 242 docker search --trusted 243 244 **Deprecated In Release: [v1.5.0](https://github.com/docker/docker/releases/tag/v1.5.0)** 245 246 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 247 248 The single-dash (`-help`) was removed, in favor of the double-dash `--help` 249 250 docker -help 251 docker [COMMAND] -help 252 253 ### `--run` flag on docker commit 254 255 **Deprecated In Release: [v0.10.0](https://github.com/docker/docker/releases/tag/v0.10.0)** 256 257 **Removed In Release: [v1.13.0](https://github.com/docker/docker/releases/tag/v1.13.0)** 258 259 The flag `--run` of the docker commit (and its short version `-run`) were deprecated in favor 260 of the `--changes` flag that allows to pass `Dockerfile` commands. 261 262 263 ### Interacting with V1 registries 264 265 **Disabled By Default In Release: v1.14** 266 267 **Target For Removal In Release: v1.17** 268 269 Version 1.9 adds a flag (`--disable-legacy-registry=false`) which prevents the 270 docker daemon from `pull`, `push`, and `login` operations against v1 271 registries. Though enabled by default, this signals the intent to deprecate 272 the v1 protocol. 273 274 Support for the v1 protocol to the public registry was removed in 1.13. Any 275 mirror configurations using v1 should be updated to use a 276 [v2 registry mirror](https://docs.docker.com/registry/recipes/mirror/). 277 278 ### Docker Content Trust ENV passphrase variables name change 279 **Deprecated In Release: [v1.9.0](https://github.com/docker/docker/releases/tag/v1.9.0)** 280 281 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 282 283 Since 1.9, Docker Content Trust Offline key has been renamed to Root key and the Tagging key has been renamed to Repository key. Due to this renaming, we're also changing the corresponding environment variables 284 285 - DOCKER_CONTENT_TRUST_OFFLINE_PASSPHRASE is now named DOCKER_CONTENT_TRUST_ROOT_PASSPHRASE 286 - DOCKER_CONTENT_TRUST_TAGGING_PASSPHRASE is now named DOCKER_CONTENT_TRUST_REPOSITORY_PASSPHRASE