{"id":48454,"date":"2025-02-08T08:40:54","date_gmt":"2025-02-08T08:40:54","guid":{"rendered":"https:\/\/www.devopsschool.com\/blog\/?p=48454"},"modified":"2026-02-21T07:25:52","modified_gmt":"2026-02-21T07:25:52","slug":"docker-tag","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/docker-tag\/","title":{"rendered":"Docker commands Guide – docker tag with examples"},"content":{"rendered":"\n

Here\u2019s a complete tutorial<\/strong> on docker tag<\/code>, covering what it does<\/strong>, examples<\/strong>, and use cases<\/strong>.<\/p>\n\n\n\n

\n\n\n\n

What is docker tag<\/code>?<\/strong><\/h2>\n\n\n\n

docker tag<\/code> is a Docker command that creates a new tag<\/strong> (alias) for an existing Docker image. It does not create a new image<\/strong> but assigns a new name or version tag<\/strong> to an existing image ID. This is useful for version control, renaming images, or preparing images for deployment to a registry.<\/p>\n\n\n\n

Key Features:<\/strong><\/h3>\n\n\n\n
    \n
  • Assign multiple tags<\/strong> to the same image.<\/li>\n\n\n\n
  • Rename images<\/strong> for better organization.<\/li>\n\n\n\n
  • Prepare images for publishing to Docker Hub or private registries<\/strong>.<\/li>\n\n\n\n
  • Helps with versioning<\/strong> and managing image lifecycle.<\/li>\n<\/ul>\n\n\n\n
    \n\n\n\n

    Basic Syntax<\/strong><\/h2>\n\n\n
    docker<\/span> tag<\/span> SOURCE_IMAGE<\/span>[:TAG]<\/span> TARGET_IMAGE<\/span>[:TAG]<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
    Arguments:<\/strong><\/h3>\n\n\n\n
      \n
    • SOURCE_IMAGE[:TAG]<\/code><\/strong>: The existing image and optional tag you want to rename.<\/li>\n\n\n\n
    • TARGET_IMAGE[:TAG]<\/code><\/strong>: The new name and optional tag for the image.<\/li>\n<\/ul>\n\n\n\n
      \n\n\n\n
      Examples of docker tag<\/code><\/strong><\/h2>\n\n\n\n
      1. Tag an Image with a New Version<\/strong><\/h3>\n\n\n
      docker<\/span> tag<\/span> my_app<\/span>:latest<\/span> my_app<\/span>:v1.0<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      This tags the my_app:latest<\/code> image as my_app:v1.0<\/code>.<\/p>\n\n\n\n
      \n\n\n\n
      2. Add a Repository Name for Pushing to Docker Hub<\/strong><\/h3>\n\n\n
      docker tag my_app:latest myusername\/my_app:latest\n<\/code><\/span><\/pre>\n\n\n
      This prepares my_app:latest<\/code> for pushing to Docker Hub under myusername<\/code>.<\/p>\n\n\n\n
      \n\n\n\n
      3. Tag an Image with a Different Registry<\/strong><\/h3>\n\n\n
      docker tag my_app:latest registry.example.com\/my_app:latest\n<\/code><\/span><\/pre>\n\n\n
      This tags the image for pushing to a private registry (registry.example.com<\/code>).<\/p>\n\n\n\n
      \n\n\n\n
      4. Create Multiple Tags for the Same Image<\/strong><\/h3>\n\n\n
      docker<\/span> tag<\/span> my_app<\/span>:latest<\/span> my_app<\/span>:stable<\/span>\ndocker<\/span> tag<\/span> my_app<\/span>:latest<\/span> my_app<\/span>:testing<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      This creates multiple tags (stable<\/code> and testing<\/code>) for the same image.<\/p>\n\n\n\n
      \n\n\n\n
      5. Tag an Image by ID<\/strong><\/h3>\n\n\n
      docker<\/span> tag<\/span> a1b2c3d4e5f6<\/span> my_app<\/span>:v2.0<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      This tags the image with ID a1b2c3d4e5f6<\/code> as my_app:v2.0<\/code>.<\/p>\n\n\n\n
      \n\n\n\n
      6. Rename an Image<\/strong><\/h3>\n\n\n
      docker<\/span> tag<\/span> old_name<\/span>:latest<\/span> new_name<\/span>:latest<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      This renames old_name:latest<\/code> to new_name:latest<\/code>.<\/p>\n\n\n\n
      \n\n\n\n
      7. Prepare an Image for Kubernetes Deployment<\/strong><\/h3>\n\n\n
      docker tag my_app:latest registry.example.com\/project\/my_app:v1.0.0\n<\/code><\/span><\/pre>\n\n\n
      This tags the image for deployment to a Kubernetes cluster using a specific registry.<\/p>\n\n\n\n
      \n\n\n\n
      8. Use docker tag<\/code> in Automation Scripts<\/strong><\/h3>\n\n\n
      #!\/bin\/bash<\/span>\ndocker tag my_app:latest my_app:backup_$(date +%Y%m%d)\necho \"Image tagged as my_app:backup_$(date +%Y%m%d)\"<\/span>\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      This script tags the image with a timestamp.<\/p>\n\n\n\n
      \n\n\n\n
      9. Version Control with Semantic Tagging<\/strong><\/h3>\n\n\n
      docker<\/span> tag<\/span> my_app<\/span>:latest<\/span> my_app<\/span>:1.0.0<\/span>\ndocker<\/span> tag<\/span> my_app<\/span>:latest<\/span> my_app<\/span>:1.0<\/span>\ndocker<\/span> tag<\/span> my_app<\/span>:latest<\/span> my_app<\/span>:1<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      This helps maintain semantic versioning (major.minor.patch<\/code>).<\/p>\n\n\n\n
      \n\n\n\n
      10. Tag a Multi-Architecture Image<\/strong><\/h3>\n\n\n\n
      If you are building for multiple architectures (linux\/amd64<\/code>, linux\/arm64<\/code>), tag each architecture-specific image:<\/p>\n\n\n
      docker<\/span> tag<\/span> my_app<\/span>:arm64<\/span> my_app<\/span>:latest-arm64<\/span>\ndocker<\/span> tag<\/span> my_app<\/span>:amd64<\/span> my_app<\/span>:latest-amd64<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      \n\n\n\n
      Use Cases for docker tag<\/code><\/strong><\/h2>\n\n\n\n
      1. Version Control and Image Management<\/strong><\/h3>\n\n\n\n
        \n
      • Tag images with version numbers<\/strong> for easy reference and rollback.<\/li>\n\n\n\n
      • Example: my_app:v1.0<\/code>, my_app:v2.0<\/code>.<\/li>\n<\/ul>\n\n\n\n
        2. Preparing Images for Deployment<\/strong><\/h3>\n\n\n\n
          \n
        • Add a tag for pushing images<\/strong> to Docker Hub or private registries.<\/li>\n\n\n\n
        • Example: myusername\/my_app:latest<\/code>.<\/li>\n<\/ul>\n\n\n\n
          3. Multi-Environment Workflows<\/strong><\/h3>\n\n\n\n
            \n
          • Tag images for different environments<\/strong> (development, staging, production).<\/li>\n\n\n\n
          • Example: my_app:dev<\/code>, my_app:staging<\/code>, my_app:prod<\/code>.<\/li>\n<\/ul>\n\n\n\n
            4. Renaming Images<\/strong><\/h3>\n\n\n\n
              \n
            • Change image names for better organization or when switching repositories.<\/li>\n\n\n\n
            • Example: Rename old_app:latest<\/code> to new_app:latest<\/code>.<\/li>\n<\/ul>\n\n\n\n
              5. Automating CI\/CD Pipelines<\/strong><\/h3>\n\n\n\n
                \n
              • Use docker tag<\/code> in CI\/CD pipelines to version and push images<\/strong> automatically.<\/li>\n\n\n\n
              • Example: Tagging with Git commit hashes or build numbers (my_app:build_123<\/code>).<\/li>\n<\/ul>\n\n\n\n
                6. Backup and Rollback<\/strong><\/h3>\n\n\n\n
                  \n
                • Create backup tags before making changes, allowing for easy rollback.<\/li>\n\n\n\n
                • Example: my_app:backup_20260207<\/code>.<\/li>\n<\/ul>\n\n\n\n
                  7. Multi-Registry Support<\/strong><\/h3>\n\n\n\n
                    \n
                  • Prepare images for multiple registries<\/strong> (Docker Hub, AWS ECR, Google Artifact Registry).<\/li>\n\n\n\n
                  • Example: docker tag my_app:latest gcr.io\/project\/my_app:latest<\/code>.<\/li>\n<\/ul>\n\n\n\n
                    \n\n\n\n
                    List of Common docker tag<\/code> Commands<\/strong><\/h2>\n\n\n\n
                    Command<\/strong><\/th>Description<\/strong><\/th><\/tr><\/thead>
                    docker tag my_app:latest my_app:v1.0<\/code><\/td>Tag my_app:latest<\/code> as my_app:v1.0<\/code><\/td><\/tr>
                    docker tag my_app:latest myusername\/my_app:latest<\/code><\/td>Add a repository name for Docker Hub<\/td><\/tr>
                    docker tag my_app:latest registry.example.com\/my_app:latest<\/code><\/td>Tag for a private registry<\/td><\/tr>
                    docker tag old_image:latest new_image:latest<\/code><\/td>Rename an image<\/td><\/tr>
                    docker tag a1b2c3d4e5f6 my_app:v2.0<\/code><\/td>Tag an image by its ID<\/td><\/tr>
                    docker tag my_app:latest my_app:backup_20260207<\/code><\/td>Create a timestamped backup tag<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                    \n\n\n\n
                    Best Practices for Using docker tag<\/code>:<\/strong><\/h2>\n\n\n\n
                      \n
                    1. Follow semantic versioning<\/strong> (major.minor.patch<\/code>) to maintain a clear image versioning strategy.<\/li>\n\n\n\n
                    2. Use meaningful tags<\/strong> for different environments (dev<\/code>, staging<\/code>, prod<\/code>).<\/li>\n\n\n\n
                    3. Tag before pushing<\/strong> to a registry for clarity and traceability.<\/li>\n\n\n\n
                    4. Automate tagging<\/strong> in CI\/CD pipelines for consistent version control.<\/li>\n\n\n\n
                    5. Avoid ambiguous tags<\/strong> like latest<\/code> in production\u2014always prefer versioned tags.<\/li>\n<\/ol>\n\n\n\n
                      \n\n\n\n
                      Common Errors and Solutions<\/strong><\/h2>\n\n\n\n
                        \n
                      1. “No such image”<\/strong>
                        \u2192 Ensure the source image exists. Use docker images<\/code> to verify.<\/li>\n\n\n\n
                      2. “Image is already tagged”<\/strong>
                        \u2192 This is a warning, not an error. You can re-tag an image with different tags.<\/li>\n\n\n\n
                      3. “Repository name must be lowercase”<\/strong>
                        \u2192 Docker image names must be lowercase (e.g., my_app<\/code>, not My_App<\/code>).<\/li>\n<\/ol>\n\n\n\n
                        \n\n\n\n
                        Combining docker tag<\/code> with Other Commands<\/strong><\/h2>\n\n\n\n
                        Push Tagged Images to Docker Hub<\/strong><\/h3>\n\n\n
                        docker tag my_app:latest myusername\/my_app:latest\ndocker push myusername\/my_app:latest\n<\/code><\/span><\/pre>\n\n\n
                        Automate Versioning in CI\/CD<\/strong><\/h3>\n\n\n
                        docker<\/span> build<\/span> -t<\/span> my_app<\/span>:latest<\/span> .\ndocker<\/span> tag<\/span> my_app<\/span>:latest<\/span> my_app<\/span>:v1.0.0<\/span>\ndocker<\/span> push<\/span> my_app<\/span>:v1.0.0<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
                        Rollback to a Previous Version<\/strong><\/h3>\n\n\n
                        docker<\/span> tag<\/span> my_app<\/span>:v1.0<\/span> my_app<\/span>:latest<\/span>\ndocker<\/span> run<\/span> my_app<\/span>:latest<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
                        \n\n\n\n
                        <\/p>\n","protected":false},"excerpt":{"rendered":"
                        Here\u2019s a complete tutorial on docker tag, covering what it does, examples, and use cases. What is docker tag? docker tag is a Docker command that creates a new tag… <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"_joinchat":[],"footnotes":""},"categories":[4862],"tags":[],"class_list":["post-48454","post","type-post","status-publish","format-standard","hentry","category-docker"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/48454","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/comments?post=48454"}],"version-history":[{"count":3,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/48454\/revisions"}],"predecessor-version":[{"id":58894,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/48454\/revisions\/58894"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=48454"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=48454"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=48454"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}