2015-06-07 20:07:20 -07:00
|
|
|
<!--[metadata]>
|
|
|
|
+++
|
|
|
|
title = "Getting started with Docker Hub"
|
|
|
|
description = "Introductory guide to getting an account on Docker Hub"
|
|
|
|
keywords = ["documentation, docs, the docker guide, docker guide, docker, docker platform, virtualization framework, docker.io, central service, services, how to, container, containers, automation, collaboration, collaborators, registry, repo, repository, technology, github webhooks, trusted builds"]
|
|
|
|
[menu.main]
|
|
|
|
parent = "smn_pubhub"
|
|
|
|
weight = 1
|
|
|
|
+++
|
|
|
|
<![end-metadata]-->
|
2014-05-22 07:05:19 +10:00
|
|
|
|
2015-04-21 17:50:09 +02:00
|
|
|
# Getting started with Docker Hub
|
2014-05-22 07:05:19 +10:00
|
|
|
|
|
|
|
|
2014-07-17 16:41:50 -07:00
|
|
|
This section provides a quick introduction to the [Docker Hub](https://hub.docker.com),
|
|
|
|
including how to create an account.
|
2014-05-22 07:05:19 +10:00
|
|
|
|
2014-06-18 17:50:24 -07:00
|
|
|
The [Docker Hub](https://hub.docker.com) is a centralized resource for working with
|
|
|
|
Docker and its components. Docker Hub helps you collaborate with colleagues and get the
|
2015-04-08 10:30:42 +02:00
|
|
|
most out of Docker. To do this, it provides services such as:
|
2014-05-22 07:05:19 +10:00
|
|
|
|
2014-06-18 17:50:24 -07:00
|
|
|
* Docker image hosting.
|
2014-05-22 07:05:19 +10:00
|
|
|
* User authentication.
|
2014-06-18 17:50:24 -07:00
|
|
|
* Automated image builds and work-flow tools such as build triggers and web
|
2014-05-22 07:05:19 +10:00
|
|
|
hooks.
|
2015-06-13 09:21:50 -07:00
|
|
|
* Integration with GitHub and Bitbucket.
|
2014-05-22 07:05:19 +10:00
|
|
|
|
2014-06-18 17:50:24 -07:00
|
|
|
In order to use Docker Hub, you will first need to register and create an account. Don't
|
|
|
|
worry, creating an account is simple and free.
|
2014-05-22 07:05:19 +10:00
|
|
|
|
2015-04-21 17:50:09 +02:00
|
|
|
## Creating a Docker Hub account
|
2014-05-22 07:05:19 +10:00
|
|
|
|
2014-07-17 16:41:50 -07:00
|
|
|
There are two ways for you to register and create an account:
|
2014-05-22 07:05:19 +10:00
|
|
|
|
2014-06-18 17:50:24 -07:00
|
|
|
1. Via the web, or
|
|
|
|
2. Via the command line.
|
2014-05-22 07:05:19 +10:00
|
|
|
|
2014-06-18 17:50:24 -07:00
|
|
|
### Register via the web
|
2014-05-22 07:05:19 +10:00
|
|
|
|
2014-06-18 17:50:24 -07:00
|
|
|
Fill in the [sign-up form](https://hub.docker.com/account/signup/) by
|
2014-07-17 16:41:50 -07:00
|
|
|
choosing your user name and password and entering a valid email address. You can also
|
|
|
|
sign up for the Docker Weekly mailing list, which has lots of information about what's
|
|
|
|
going on in the world of Docker.
|
2014-05-22 07:05:19 +10:00
|
|
|
|
|
|
|
![Register using the sign-up page](/userguide/register-web.png)
|
|
|
|
|
2014-06-18 17:50:24 -07:00
|
|
|
### Register via the command line
|
2014-05-22 07:05:19 +10:00
|
|
|
|
2014-06-18 17:50:24 -07:00
|
|
|
You can also create a Docker Hub account via the command line with the
|
2014-05-22 07:05:19 +10:00
|
|
|
`docker login` command.
|
|
|
|
|
2015-03-26 11:12:37 -07:00
|
|
|
$ docker login
|
2014-05-22 07:05:19 +10:00
|
|
|
|
|
|
|
### Confirm your email
|
|
|
|
|
2014-07-17 16:41:50 -07:00
|
|
|
Once you've filled in the form, check your email for a welcome message asking for
|
|
|
|
confirmation so we can activate your account.
|
2014-05-22 07:05:19 +10:00
|
|
|
|
|
|
|
|
2014-06-18 17:50:24 -07:00
|
|
|
### Login
|
2014-05-22 07:05:19 +10:00
|
|
|
|
2014-06-18 17:50:24 -07:00
|
|
|
After you complete the confirmation process, you can login using the web console:
|
2014-05-22 07:05:19 +10:00
|
|
|
|
|
|
|
![Login using the web console](/userguide/login-web.png)
|
|
|
|
|
2014-06-18 17:50:24 -07:00
|
|
|
Or via the command line with the `docker login` command:
|
2014-05-22 07:05:19 +10:00
|
|
|
|
2015-03-26 11:12:37 -07:00
|
|
|
$ docker login
|
2014-05-22 07:05:19 +10:00
|
|
|
|
2014-07-17 16:41:50 -07:00
|
|
|
Your Docker Hub account is now active and ready to use.
|
2014-05-22 07:05:19 +10:00
|
|
|
|
|
|
|
## Next steps
|
|
|
|
|
2014-07-01 15:07:05 -07:00
|
|
|
Next, let's start learning how to Dockerize applications with our "Hello world"
|
2014-06-18 17:50:24 -07:00
|
|
|
exercise.
|
2014-05-22 07:05:19 +10:00
|
|
|
|
|
|
|
Go to [Dockerizing Applications](/userguide/dockerizing).
|
|
|
|
|