docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
docs/content/guides/walkthroughs/publish-your-image.md

2.4 KiB
Raw Blame History

title keywords description aliases
Publish your image get started, quick start, intro, concepts Learn how to publish your image to Docker Hub
/get-started/publish-your-own-image/

Follow this walkthrough to learn how to publish and share your images on Docker Hub.

{{< include "guides-get-docker.md" >}}

Step 1: Get the example image

To get the example image:

  1. In Docker Desktop, select the search bar.
  2. In the search bar, specify docker/welcome-to-docker.
  3. Select Pull to pull the image from Docker Hub to you computer.

Search Docker Desktop for the welcome-to-docker image

Step 2: Sign in to Docker

Select Sign in on the top-right of Docker Desktop to either sign in or create a new Docker account.

Signing in to Docker Desktop

Step 3: Rename your image

Before you can publish your image, you need to rename it so that Docker Hub knows that the image is yours. In a terminal, run the following command to rename your image. Replace YOUR-USERNAME with your Docker ID.

{{< include "open-terminal.md" >}}

$ docker tag docker/welcome-to-docker YOUR-USERNAME/welcome-to-docker

Step 4: Push your image to Docker Hub

To push your image to Docker Hub:

  1. In Docker Desktop, go to the Images tab
  2. In the Actions column for your image, select the Show image actions icon.
  3. Select Push to Hub.

Pushing an image to Docker Hub

Go to Docker Hub⁠ and verify that the list of your repositories now contains YOUR-USERNAME/welcome-to-docker.

Summary

In this walkthrough, you pushed and shared an image on Docker Hub.

Related information:

Next steps

Continue to the language-specific guides to learn how you can use Docker to containerize and develop applications in your favorite language. Choose one of the following guides.