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.
  • 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 a Repository on the Docker Hub welcome page:


  3. Name it <your-username>/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

  1. Start by creating a Dockerfile to specify your application as shown below:
    cat > Dockerfile <<EOF
    FROM busybox
    CMD echo "Hello world! This is my first Docker image."
  2. Run docker build -t <your_username>/my-first-repo . to build your Docker image.

  3. Run docker run <your_username>/my-first-repo to test your Docker image locally.

  4. 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