docs/content/guides/walkthroughs/publish-your-image.md

72 lines
2.4 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: Publish your image
keywords: get started, quick start, intro, concepts
description: Learn how to publish your image to Docker Hub
aliases:
- /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](images/getting-started-search.webp?w=650&border=true)
## 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](images/getting-started-signin.webp?w=300&border=true)
## 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" >}}
```console
$ 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](images/getting-started-push.webp?border=true)
Go to [Docker Hub](https://hub.docker.com) 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:
- Deep dive into the [Docker Hub manual](../../docker-hub/_index.md)
- Learn more about the [docker tag](../../reference/cli/docker/image/tag.md)
command
## 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.
- [C# (.NET)](../../language/dotnet/_index.md)
- [Go](../../language/golang/_index.md)
- [Java](../../language/java/_index.md)
- [Node.js](../../language/nodejs/_index.md)
- [PHP](../../language/php/_index.md)
- [Python](../../language/python/_index.md)
- [Rust](../../language/rust/_index.md)