Muhammad Sufiyan's Blog

Publishing Docker Images to Docker Hub

Muhammad Sufiyan's photo
Muhammad Sufiyan
·

3 min read

In this guide, we will walk through the process of building, tagging, and pushing a Docker image to Docker Hub, making it accessible from anywhere on the cloud. This process is crucial for deploying your applications to servers or sharing them with others.

Step 1: Build Your Docker Image

Before you can push an image to Docker Hub, you need to build it locally using your Dockerfile. Run the following command:

docker build -t <username>/<image-name>:<tag> .

  • Replace <username> with your Docker Hub username.

  • Replace <image-name> with the name of your project.

  • Replace <tag> with a version tag (e.g., latest or v1.0).

Example:

docker build -t smit-b-11:latest .

Step 2: Log In to Docker Hub

Ensure you are authenticated with Docker Hub. Use the docker login command:

docker login

Provide your Docker Hub username and password when prompted.

Step 3: Tag Your Docker Image

If you didn’t tag the image during the build process, you can do so now:

docker tag <local-image> <username>/<repository>:<tag>

Example:

docker tag smit-b-11:latest myusername/nascar-project:latest

Step 4: Push the Image to Docker Hub

Push the tagged image to Docker Hub using the docker push command:

docker push <username>/<repository>:<tag>

Example:

docker push myusername/smit-b-11:latest

Docker will upload your image in chunks to the Docker Hub repository. Once the process is complete, you’ll see a confirmation message with a SHA hash.

Step 5: Verify the Image on Docker Hub

  1. Log in to your Docker Hub account.

  2. Navigate to the "Repositories" section.

  3. Locate your repository (e.g., myusername/nascar-project).

  4. Verify the uploaded image and its tags (e.g., latest).

By default, new repositories are private. You can adjust their visibility settings on Docker Hub if needed.

Step 6: Use the Docker Image

Your image is now hosted on Docker Hub and can be used in various ways:

a. Download and Run the Image on Any Server

Use the docker pull command to download the image:

docker pull <username>/<repository>:<tag>

Example:

docker pull myusername/smit-b-11:latest

Then run it:

docker run -p 5000:5000 <username>/<repository>:<tag>

b. Extend the Image in Another Dockerfile

You can use your uploaded image as a base image for other Dockerfiles:

FROM <username>/<repository>:<tag>

# Add your customizations here

Example:

FROM myusername/smit-b-11:latest

WORKDIR /app
COPY . .
RUN npm install
CMD ["npm", "start"]

Conclusion

By pushing your Docker image to Docker Hub, you make it accessible for deployments, testing, or collaboration. This image can now be used across different environments and servers, enabling seamless cloud deployments.

In the next step, we’ll explore how to deploy this image to a cloud server. Stay tuned!

Dockerdocker images