2014-04-16 18:07:55 +00:00
|
|
|
% DOCKER(1) Docker User Manuals
|
2014-07-01 02:58:04 +00:00
|
|
|
% Docker Community
|
|
|
|
% JUNE 2014
|
2014-04-16 18:07:55 +00:00
|
|
|
# NAME
|
2014-07-01 02:58:04 +00:00
|
|
|
docker-tag - Tag an image into a repository
|
2014-04-16 18:07:55 +00:00
|
|
|
|
|
|
|
# SYNOPSIS
|
2014-07-01 02:58:04 +00:00
|
|
|
**docker tag**
|
|
|
|
[**-f**|**--force**[=*false*]]
|
2014-10-15 21:14:12 +00:00
|
|
|
[**--help**]
|
2015-04-01 19:20:59 +00:00
|
|
|
IMAGE[:TAG] [REGISTRY_HOST/][USERNAME/]NAME[:TAG]
|
2014-04-16 18:07:55 +00:00
|
|
|
|
|
|
|
# DESCRIPTION
|
2015-04-01 19:20:59 +00:00
|
|
|
Assigns a new alias to an image in a registry. An alias refers to the
|
|
|
|
entire image name including the optional `TAG` after the ':'.
|
|
|
|
|
|
|
|
If you do not specify a `REGISTRY_HOST`, the command uses Docker's public
|
|
|
|
registry located at `registry-1.docker.io` by default.
|
2014-04-16 18:07:55 +00:00
|
|
|
|
|
|
|
# "OPTIONS"
|
2014-04-17 15:36:58 +00:00
|
|
|
**-f**, **--force**=*true*|*false*
|
2014-06-01 23:16:14 +00:00
|
|
|
When set to true, force the alias. The default is *false*.
|
2014-04-16 18:07:55 +00:00
|
|
|
|
|
|
|
**REGISTRYHOST**
|
2014-04-17 15:36:58 +00:00
|
|
|
The hostname of the registry if required. This may also include the port
|
2014-04-16 18:07:55 +00:00
|
|
|
separated by a ':'
|
|
|
|
|
|
|
|
**USERNAME**
|
2014-04-17 15:36:58 +00:00
|
|
|
The username or other qualifying identifier for the image.
|
2014-04-16 18:07:55 +00:00
|
|
|
|
|
|
|
**NAME**
|
2014-04-17 15:36:58 +00:00
|
|
|
The image name.
|
2014-04-16 18:07:55 +00:00
|
|
|
|
|
|
|
**TAG**
|
2014-05-31 21:44:17 +00:00
|
|
|
The tag you are assigning to the image. Though this is arbitrary it is
|
2014-07-10 04:14:06 +00:00
|
|
|
recommended to be used for a version to distinguish images with the same name.
|
2015-07-01 15:15:17 +00:00
|
|
|
Also, for consistency tags should only include a-z0-9-_. .
|
2014-05-31 21:44:17 +00:00
|
|
|
Note that here TAG is a part of the overall name or "tag".
|
2014-04-17 15:36:58 +00:00
|
|
|
|
2014-07-01 02:58:04 +00:00
|
|
|
# OPTIONS
|
|
|
|
**-f**, **--force**=*true*|*false*
|
|
|
|
Force. The default is *false*.
|
|
|
|
|
2014-04-16 18:07:55 +00:00
|
|
|
# EXAMPLES
|
|
|
|
|
2014-06-01 23:16:14 +00:00
|
|
|
## Giving an image a new alias
|
2014-04-16 18:07:55 +00:00
|
|
|
|
2014-06-30 01:31:15 +00:00
|
|
|
Here is an example of aliasing an image (e.g., 0e5574283393) as "httpd" and
|
2014-05-31 21:44:17 +00:00
|
|
|
tagging it into the "fedora" repository with "version1.0":
|
2014-04-16 18:07:55 +00:00
|
|
|
|
|
|
|
docker tag 0e5574283393 fedora/httpd:version1.0
|
|
|
|
|
|
|
|
## Tagging an image for a private repository
|
|
|
|
|
2015-08-03 16:51:10 +00:00
|
|
|
To push an image to a private registry and not the central Docker
|
2014-04-16 18:07:55 +00:00
|
|
|
registry you must tag it with the registry hostname and port (if needed).
|
|
|
|
|
|
|
|
docker tag 0e5574283393 myregistryhost:5000/fedora/httpd:version1.0
|
|
|
|
|
|
|
|
# HISTORY
|
2014-04-17 15:36:58 +00:00
|
|
|
April 2014, Originally compiled by William Henry (whenry at redhat dot com)
|
2014-07-02 00:30:25 +00:00
|
|
|
based on docker.com source material and internal work.
|
2014-07-03 01:07:42 +00:00
|
|
|
June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
|
2014-07-23 02:40:10 +00:00
|
|
|
July 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
|
2015-04-01 19:20:59 +00:00
|
|
|
April 2015, updated by Mary Anthony for v2 <mary@docker.com>
|
2015-07-01 15:15:17 +00:00
|
|
|
June 2015, updated by Sally O'Malley <somalley@redhat.com>
|