Advisory: This site contains documentation for the v1.12 release candidate version of Docker Engine. For the Docker Engine v1.11 docs, see https://docs.docker.com/v1.11/. Docker for Mac and Docker for Windows are currently in Beta.
Usage: docker tag IMAGE[:TAG] IMAGE[:TAG] Tag an image into a repository Options: --help Print usage
An image name is made up of slash-separated name components, optionally prefixed
by a registry hostname. The hostname must comply with standard DNS rules, but
may not contain underscores. If a hostname is present, it may optionally be
followed by a port number in the format
:8080. If not present, the command
uses Docker’s public registry located at
registry-1.docker.io by default. Name
components may contain lowercase characters, digits and separators. A separator
is defined as a period, one or two underscores, or one or more dashes. A name
component may not start or end with a separator.
A tag name may contain lowercase and uppercase characters, digits, underscores, periods and dashes. A tag name may not start with a period or a dash and may contain a maximum of 128 characters.
You can group your images together using names and tags, and then upload them to Share Images via Repositories.
To tag a local image with ID “0e5574283393” into the “fedora” repository with “version1.0”:
docker tag 0e5574283393 fedora/httpd:version1.0
To tag a local image with name “httpd” into the “fedora” repository with “version1.0”:
docker tag httpd fedora/httpd:version1.0
Note that since the tag name is not specified, the alias is created for an
existing local version
To tag a local image with name “httpd” and tag “test” into the “fedora” repository with “version1.0.test”:
docker tag httpd:test fedora/httpd:version1.0.test
To push an image to a private registry and not the central Docker registry you must tag it with the registry hostname and port (if needed).
docker tag 0e5574283393 myregistryhost:5000/fedora/httpd:version1.0