github.com/circular-dark/docker@v1.7.0/docs/docker-hub/accounts.md (about)

     1  <!--[metadata]>
     2  +++
     3  title = "Accounts on Docker Hub"
     4  description = "Docker Hub accounts"
     5  keywords = ["Docker, docker, registry, accounts, plans, Dockerfile, Docker Hub, docs,  documentation"]
     6  [menu.main]
     7  parent = "smn_pubhub"
     8  weight = 1
     9  +++
    10  <![end-metadata]-->
    11  
    12  # Accounts on Docker Hub
    13  
    14  ## Docker Hub accounts
    15  
    16  You can `search` for Docker images and `pull` them from [Docker
    17  Hub](https://hub.docker.com) without signing in or even having an
    18  account. However, in order to `push` images, leave comments or to *star*
    19  a repository, you are going to need a [Docker
    20  Hub](https://hub.docker.com) account.
    21  
    22  ### Registration for a Docker Hub account
    23  
    24  You can get a [Docker Hub](https://hub.docker.com) account by
    25  [signing up for one here](https://hub.docker.com/account/signup/). A valid
    26  email address is required to register, which you will need to verify for
    27  account activation.
    28  
    29  ### Email activation process
    30  
    31  You need to have at least one verified email address to be able to use your
    32  [Docker Hub](https://hub.docker.com) account. If you can't find the validation email,
    33  you can request another by visiting the [Resend Email Confirmation](
    34  https://hub.docker.com/account/resend-email-confirmation/) page.
    35  
    36  ### Password reset process
    37  
    38  If you can't access your account for some reason, you can reset your password
    39  from the [*Password Reset*](https://hub.docker.com/account/forgot-password/)
    40  page.
    41  
    42  ## Organizations and groups
    43  
    44  A Docker Hub organization contains public and private repositories just like
    45  a user account. Access to push, pull or create these organisation owned repositories
    46  is allocated by defining groups of users and then assigning group rights to
    47  specific repositories. This allows you to distribute limited access
    48  Docker images, and to select which Docker Hub users can publish new images.
    49  
    50  ### Creating and viewing organizations
    51  
    52  You can see what organizations [you belong to and add new organizations](
    53  https://hub.docker.com/account/organizations/) from the Account Settings
    54  tab. They are also listed below your user name on your repositories page
    55  and in your account profile.
    56  
    57  ![organizations](/docker-hub/hub-images/orgs.png)
    58  
    59  ### Organization groups
    60  
    61  Users in the `Owners` group of an organization can create and modify the
    62  membership of groups.
    63  
    64  Unless they are the organization's `Owner`, users can only see groups of which they
    65  are members.
    66  
    67  ![groups](/docker-hub/hub-images/groups.png)
    68  
    69  ### Repository group permissions
    70  
    71  Use organization groups to manage who can interact with your repositories.
    72  
    73  You need to be a member of the organization's `Owners` group to create a new group,
    74  Hub repository or automated build. As an `Owner`, you then delegate the following
    75  repository access rights to groups:
    76  
    77  - `Read` access allows a user to view, search, and pull a private repository in the
    78    same way as they can a public repository.
    79  - `Write` access users are able to push to non-automated repositories on the Docker
    80    Hub.
    81  - `Admin` access allows the user to modify the repositories "Description", "Collaborators" rights,
    82    "Mark as unlisted", "Public/Private" status and "Delete".
    83  
    84  > **Note**: A User who has not yet verified their email address will only have
    85  > `Read` access to the repository, regardless of the rights their group membership
    86  >  gives them.
    87  
    88  ![Organization repository collaborators](/docker-hub/hub-images/org-repo-collaborators.png)
    89  
    90