Docker Push an Image to Registry (Docker Hub)

In this quick guide, we will see how to use the docker push command to push a Docker image or repository to Docker Hub.

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

The Basics of Docker Push

To send a local Docker image to a remote registry, you utilize the docker push command. 


docker push [OPTIONS] NAME[:TAG]

NAME: This represents the name of the image. 

TAG: Specify the version of the image. If no TAG is provided, Docker will use the "latest" version by default.

Example: Steps to Push Image to Docker Hub

Pushing an image to Docker Hub involves a series of steps to ensure that the image is correctly tagged and that you have the appropriate permissions to push it to your account. Let's walk through these steps in detail:

1. Create a Docker Hub Account: 

If you don’t already have a Docker Hub account, you need to sign up for one: 

  1. Go to Docker Hub. 
  2. Click on "Sign Up" and follow the registration process. 

2. Login to Docker CLI: 

Before you can push an image, you need to authenticate your Docker client to your Docker Hub account:

docker login

When prompted, provide your Docker Hub username and password. If authentication is successful, you'll receive a Login Succeeded message.

3. Create or Identify Your Image: 

If you've already created a Docker image, you can skip this step. If not, here's a quick reminder on how to build one:

docker build -t your-image-name ./path-to-your-dockerfile

4. Tag the Image: 

Docker Hub uses a namespace (usually your username) and repository name to organize images. Before pushing, you need to tag your image using this format: username/repository-name:tag

If your Docker Hub username is javaguides and you want to name your repository my-app with a tag of v1, you'd do the following:

docker tag your-image-name javaguides/my-app:v1

5. Push the Image: 

Now that the image is tagged appropriately, you can push it to Docker Hub:

docker push johndoe/my-app:v1

Docker will then start to push each layer of your image to Docker Hub. Once the process completes, your image will be available on Docker Hub under the specified repository and tag. 

6. Verify the Image on Docker Hub: 

Go to your Docker Hub dashboard: 

  • Navigate to "Repositories."
  • Click on your my-app repository. 
  • You should see the v1 tag listed among the tags for this repository.


Pushing images to Docker Hub makes them publicly available, enabling others to pull and use your containerized apps or utilities. It's a valuable way to distribute and share software within the vast Docker community. However, always ensure that your images don't contain sensitive information and are free from vulnerabilities before sharing them.

Related Docker Image Management Guides