Teams & Organizations

Estimated reading time: 4 minutes

Docker Hub Organizations let you create teams so you can give your team access to shared image repositories.

  • Organizations are collections of teams and repositories that can be managed together.
  • Teams are groups of Docker Hub users that belong to an organization.

Note: in Docker Hub, users cannot belong directly to an organization. They belong only to teams within an organization.

Working with organizations

Create an organization

  1. Start by clicking on Organizations in Docker Hub.

  2. Click on Create Organization.

  3. Provide information about your organization:

    Create organization

You’ve created an organization. You’ll see you have a team, the owners team with a single member (you!).

The owners team

The owners team is a special team that has full access to all repositories in the organization.

Members of this team can:

  • Manage organization settings and billing
  • Create a team and modify the membership of any team
  • Access and modify any repository belonging to the organization

Working with teams and members

Create a team

  1. Go to Organizations in Docker Hub, and select your organization.

  2. Open the Teams tab and click Create Team.

    Teams view

  3. Fill out your team’s information and click Create.

    Create a team

Add a member to a team

You can add a member to a team in one of two ways.

If the user isn’t in your organization:

  1. Go Organizations in Docker Hub, and select your organization.

  2. Click Add Member.

    Add member from members list

  3. Provide the user’s Docker ID username or email, and select a team from the dropdown.

    Add user to team from org page

If the user already belongs to another team in the organization:

  1. Open the team’s page in Docker Hub: Organizations > Your Organization > Teams > Your Team Name

  2. Click Add User.
  3. Provide the user’s Docker ID username or email to add them to the team.

    Add user to team from team page

    Note: You are not automatically added to teams created by your organization.

Remove team members

To remove a member from all teams in an organization:

  1. Go Organizations in Docker Hub, and select your organization.

  2. Click the x next to a member’s name:

    Add User to Team

To remove a member from a specific team:

  1. Open the team this user is on. You can do this in one of two ways:

    • If you know the team name, go to Organizations > Your Organization > Teams > Team Name.

      Note: You can filter the Teams tab by username, but you have to use the format @username in the search field (partial names will not work).

    • If you don’t know the team name, go to Organizations > Your Organization and search for the user. Hover over View to see all of their teams, then click on View > Team Name.

  2. Find the user in the list, and click the x next to the user’s name to remove them.

    List of members on a team

Give a team access to a repository

  1. Visit the repository list on Docker Hub by clicking on Repositories.

  2. Select your organization in the namespace dropdown list.

  3. Click the repository you’d like to edit.

    Org Repos

  4. Click the Permissions tab.

  5. Select the team, the permissions level, and click + to save.

    Add Repo Permissions for Team

View a team’s permissions for all repositories

To view a team’s permissions over all repos:

  1. Open Organizations > Your Organization > Teams > Team Name.

  2. Click on the Permissions tab, where you can view the repositories this team can access.

    Team Audit Permissions

You can also edit repository permissions from this tab.

Permissions reference

Permissions are cumulative. For example, if you have Write permissions, you automatically have Read permissions:

  • Read access allows users to view, search, and pull a private repository in the same way as they can a public repository.
  • Write access allows users to push to repositories on Docker Hub.
  • Admin access allows users to modify the repositories “Description”, “Collaborators” rights, “Public/Private” visibility, and “Delete”.

Note: A User who has not yet verified their email address only has Read access to the repository, regardless of the rights their team membership has given them.

Docker, docker, registry, teams, organizations, plans, Dockerfile, Docker Hub, docs, documentation