Docker Hub Quickstart

Estimated reading time: 2 minutes

Docker Hub is a service provided by Docker for finding and sharing container images with your team. It provides the following major features:

  • Repositories: Push and pull container images.
  • Teams & Organizations: Manage access to private repositories of container images.
  • Official Images: Pull and use high-quality container images provided by Docker.
  • Publisher Images: Pull and use high-quality container images provided by external vendors. Certified images also include support and guarantee compatibility with Docker Enterprise.
  • Builds: Automatically build container images from GitHub and Bitbucket and push them to Docker Hub
  • Webhooks: Trigger actions after a successful push to a repository to integrate Docker Hub with other services.

Step 1: Sign up for Docker Hub

Start by creating an account.

Step 2: Create your first repository

To create a repo:

  1. Sign in to Docker Hub
  2. Click on Create Repository on the Docker Hub welcome page: Welcome
  3. Name it ** /my-first-repo** as shown below. Select **Private**:

Create Repository

You’ve created your first repo. You should see:

Repository Created

Step 3: Download and install Docker Desktop

We’ll need to download Docker Desktop to build and push a container image to Docker Hub.

  1. Download and install Docker Desktop. If on Linux, download Docker Engine - Community
  2. Open the terminal and sign in to Docker Hub on your computer by running docker login

Step 4: Build and push a container image to Docker Hub from your computer

Start by creating a Dockerfile to specify your application as shown below. (More on Dockerfiles here)

cat > Dockerfile <<EOF
FROM busybox
CMD echo "Hello world! This is my first Docker image."
  1. Run docker build -t <your_username>/my-first-repo . to build your Docker image
  2. Test your docker image locally by running docker run <your_username>/my-first-repo
  3. Run docker push <your_username>/my-first-repo to push your Docker image to Docker Hub

You should see output similar to:


And in Docker Hub, your repository should have a new latest tag available under Tags:

Tag Created

Congratulations! You’ve successfully:

  • Signed up for Docker Hub
  • Created your first repository
  • Built a Docker container image on your computer
  • Pushed it to Docker Hub

Next steps

  • Create an Organization to use Docker Hub with your team.
  • Automatically build container images from code through Builds.
  • Explore Official & Publisher Images
  • Upgrade your plan to push additional private Docker images to Docker Hub
Docker, docker, registry, accounts, plans, Dockerfile, Docker Hub, docs, documentation, accounts, organizations, repositories, groups, teams