Docker Rename image

In this quick guide, we'll explore how to effectively rename Docker images.

While Docker does not offer a direct rename command, there's a nifty workaround that achieves the same goal.

Check out all Docker tutorials and guides: Docker Tutorials and Guides

Why Rename Docker Images? 

There could be various reasons for renaming a Docker image: 

Rebranding or Reorganizing: Over time, product names or organizational naming conventions might change, requiring image names to be updated. 

Versioning: For clearer version management, you might want to adjust image names. 

Migration: If moving images between registries or namespaces, a renaming might be necessary.

Simplicity: A more concise or descriptive name might be more apt for your users or team members.

The Quick Workaround: Tag and Remove 

Docker doesn’t provide a one-liner rename operation. But, with the combination of tagging and removing, you can achieve the desired result: 

Step 1: Tag the existing image with the new name.

docker tag old-image-name:old-tag new-image-name:new-tag

Step 2: Once tagged successfully, you can remove the old tag or image.

docker rmi old-image-name:old-tag

Your Docker image now sports a brand new name without changing anything inside the actual container.

Step-by-Step Guide to "Rename" an Image

Basic Renaming:

Let's assume you have an image named myapp:latest and you want to rename it to myapp:v1.0:
docker tag myapp:latest myapp:v1.0

Changing Repository Name: 

Renaming the entire repository, for instance from myapp:latest to newapp:latest:

docker tag myapp:latest newapp:latest

Pushing to a Different Docker Registry

If you plan to push your image to Docker Hub or another registry, you might need to prefix it with a username or registry address:

docker tag myapp:latest username/myapp:latest


docker tag myapp:latest registry_address:port/myapp:latest


After you've "renamed" or retagged your image, remember that the original image is still present on your system. If it's no longer needed, you can remove it using:

docker rmi myapp:latest

Use Descriptive Names and Tags 

Renaming often stems from initially choosing names or tags that were not descriptive enough. It's good practice to use meaningful names and tags that give clear indications about the image's purpose, version, or context. 


Though Docker doesn't offer a direct renaming feature, its flexibility provides ways to achieve the same result. This ensures that your Docker environment remains organized and aligns with your evolving requirements. Remember, the key lies in understanding the difference between image names/tags and the actual image content. Happy renaming, and sail smoothly on your Docker journey!

Related Docker Image Management Guides