diff --git a/_data/toc.yaml b/_data/toc.yaml index da0d3d9fe6..dd6571853d 100644 --- a/_data/toc.yaml +++ b/_data/toc.yaml @@ -1218,6 +1218,10 @@ manuals: title: Recover your Docker Hub account - path: /docker-hub/2fa/new-recovery-code/ title: Generate a new recovery code + - path: /docker-hub/orgs/ + title: Teams and organizations + - path: /docker-hub/repos/ + title: Repositories - sectiontitle: Administration section: - path: /docker-hub/convert-account/ @@ -1236,18 +1240,10 @@ manuals: title: Add seats - path: /docker-hub/billing/remove-seats/ title: Remove seats - - path: /docker-hub/orgs/ - title: Teams and organizations - - path: /docker-hub/repos/ - title: Repositories - path: /docker-hub/vulnerability-scanning/ title: Vulnerability scanning - path: /docker-hub/official_images/ title: Official images - - path: /docker-hub/webhooks/ - title: Webhooks - - path: /docker-hub/slack_integration/ - title: Slack integration - sectiontitle: Automated builds section: - path: /docker-hub/builds/ @@ -1258,6 +1254,10 @@ manuals: title: Advanced automated builds - path: /docker-hub/builds/link-source/ title: Link to GitHub and BitBucket + - path: /docker-hub/webhooks/ + title: Webhooks + - path: /docker-hub/slack_integration/ + title: Slack integration - sectiontitle: Publisher & certified content section: - path: /docker-hub/publish/ diff --git a/docker-hub/images/index-create-repo.png b/docker-hub/images/index-create-repo.png index d96e9ee257..82f6c44e52 100644 Binary files a/docker-hub/images/index-create-repo.png and b/docker-hub/images/index-create-repo.png differ diff --git a/docker-hub/images/index-repo-created.png b/docker-hub/images/index-repo-created.png index 7b989d254f..97f1648a63 100644 Binary files a/docker-hub/images/index-repo-created.png and b/docker-hub/images/index-repo-created.png differ diff --git a/docker-hub/images/index-tag.png b/docker-hub/images/index-tag.png index aacfe16bff..9b702614d9 100644 Binary files a/docker-hub/images/index-tag.png and b/docker-hub/images/index-tag.png differ diff --git a/docker-hub/images/index-terminal-2019.png b/docker-hub/images/index-terminal-2019.png deleted file mode 100644 index 01329edf9d..0000000000 Binary files a/docker-hub/images/index-terminal-2019.png and /dev/null differ diff --git a/docker-hub/images/index-terminal.png b/docker-hub/images/index-terminal.png new file mode 100644 index 0000000000..f973d2813a Binary files /dev/null and b/docker-hub/images/index-terminal.png differ diff --git a/docker-hub/images/index-welcome.png b/docker-hub/images/index-welcome.png deleted file mode 100644 index d1521c34b0..0000000000 Binary files a/docker-hub/images/index-welcome.png and /dev/null differ diff --git a/docker-hub/index.md b/docker-hub/index.md index 766e407439..b5c13c7e8b 100644 --- a/docker-hub/index.md +++ b/docker-hub/index.md @@ -1,6 +1,6 @@ --- description: Docker Hub Quickstart -keywords: Docker, docker, registry, accounts, plans, Dockerfile, Docker Hub, docs, documentation, accounts, organizations, repositories, groups, teams +keywords: Docker, docker, registry, accounts, plans, Dockerfile, Docker Hub, accounts, organizations, repositories, groups, teams title: Docker Hub Quickstart redirect_from: - /docker-hub/overview/ @@ -77,9 +77,13 @@ redirect_from: - /apidocs/overview/ --- -[Docker Hub](https://hub.docker.com) is a service provided by Docker for -finding and sharing container images with your team. It provides the following -major features: +[Docker Hub](https://hub.docker.com){: target="_blank" rel="noopener" class="_"} is a service provided by Docker for +finding and sharing container images with your team. It is the world’s largest repository of container images with an array of content sources including container community developers, open source projects and independent software vendors (ISV) building and distributing their code in containers. + +Users get access to free public repositories for storing and sharing images or can choose a [subscription plan](https://www.docker.com/pricing){: target="_blank" rel="noopener" class="_"} for private repositories. + +Docker Hub provides the following major features: + * [Repositories](repos.md): Push and pull container images. * [Teams & Organizations](orgs.md): Manage access to private repositories of container images. @@ -92,28 +96,28 @@ GitHub and Bitbucket and push them to Docker Hub. * [Webhooks](webhooks.md): Trigger actions after a successful push to a repository to integrate Docker Hub with other services. +The following section contains step-by-step instructions on how to easily get started with Docker Hub. +### Step 1: Sign up for a Docker account -### Step 1: Sign up for Docker Hub +Let's start by creating a [Docker ID](https://hub.docker.com/signup){: target="_blank" rel="noopener" class="_"}. -Start by [creating an account](https://hub.docker.com/signup). +A Docker ID grants you access to Docker Hub repositories and allows you to explore images that are available from the community and verified publishers. You'll also need a Docker ID to share images on Docker Hub. ### Step 2: Create your first repository -To create a repo: +To create a repository: -1. Sign in to [Docker Hub](https://hub.docker.com). - -2. Click on **Create a Repository** on the Docker Hub welcome page: - - ![Welcome](images/index-welcome.png) - -3. Name it **<your-username>/my-first-repo** as shown below. Select - **Private**: +1. Sign in to [Docker Hub](https://hub.docker.com){: target="_blank" rel="noopener" class="_"}. +2. Click **Create a Repository** on the Docker Hub welcome page: +3. Name it **<your-username>/my-private-repo**. +4. Set the visibility to **Private**. ![Create Repository](images/index-create-repo.png) - You've created your first repo. You should see: +5. Click **Create**. + + You've created your first repository. You should see: ![Repository Created](images/index-repo-created.png) @@ -122,46 +126,43 @@ To create a repo: We'll need to download Docker Desktop to build and push a container image to Docker Hub. -1. Download and install [Docker Desktop](https://docker.com/get-started). If on -Linux, download [Docker Engine - Community](https://hub.docker.com/search?type=edition&offering=community). +1. Download and install [Docker Desktop](../desktop/#download-and-install). If on Linux, download [Docker Engine](../engine/install/). -2. Open the terminal and sign in to Docker Hub on your computer by running - `docker login`. +2. Sign into the Docker Desktop application using the Docker ID you created in Step 1. ### Step 4: Build and push a container image to Docker Hub from your computer -1. Start by creating a [Dockerfile](https://docs.docker.com/engine/reference/builder/) -to specify your application as shown below: -```shell -cat > Dockerfile </my-first-repo .` to build your Docker + ```shell + cat > Dockerfile </my-private-repo .` to build your Docker image. -3. Run `docker run /my-first-repo` to test your +3. Run `docker run /my-private-repo` to test your Docker image locally. -4. Run `docker push /my-first-repo` to push your Docker image to -Docker Hub. +4. Run `docker push /my-private-repo` to push your Docker image to Docker Hub. You should see output similar to: - You should see output similar to: + ![Terminal](images/index-terminal.png) - ![Terminal](images/index-terminal-2019.png) + > **Having trouble pushing?** Remember, you must be signed into Docker Hub through Docker Desktop or the command line, and you must also name your images correctly, as per the above steps. - And in Docker Hub, your repository should have a new `latest` tag available - under **Tags**: +5. Your repository in Docker Hub should now display a new `latest` tag under **Tags**: ![Tag Created](images/index-tag.png) Congratulations! You've successfully: -- Signed up for Docker Hub + +- Signed up for a Docker account - Created your first repository - Built a Docker container image on your computer -- Pushed it to Docker Hub +- Pushed it succesfully to Docker Hub ### Next steps