close
Share feedback
Answers are generated based on the documentation.

Invite and manage organization members

Table of contents

Learn how to invite and manage members for your organization in Docker Home.

Invite members

Owners can invite new members using a Docker ID, email address, or a CSV file of email addresses. If an invitee doesn't have a Docker account, they must create one and verify their email address before they can accept. Pending invitations occupy a seat.

When you invite members, you assign them a role. See Roles and permissions for details about the access permissions for each role.

You can also select one or more product licenses for an invitee. Docker assigns available licenses when they accept. Unlike a seat, licenses aren't deducted from your organization's available licenses until the invitee accepts. See Licenses and invites.

  1. Sign in to Docker Home and select your organization from the top-left account drop-down.
  2. Select Members, then Invite.
  3. Select Emails or usernames.
  4. Follow the on-screen instructions to invite members. Invite a maximum of 1000 members and separate multiple entries by comma, semicolon, or space.

  1. Sign in to Docker Home and select your organization from the top-left account drop-down. Select Members > Invite > CSV upload.

  2. Optional. Select Download the template CSV file to download an example CSV file. The following is an example of the contents of a valid CSV file:

    email
docker.user-0@example.com
docker.user-1@example.com

    CSV file requirements:

    • The file must contain a header row with at least one heading named email. Additional columns are allowed and are ignored in the import.
    • The file must contain a maximum of 1000 email addresses (rows). To invite more than 1000 members, create multiple CSV files and complete this procedure for each file.

  3. Create a new CSV file or export a CSV file from another application.

    • To export a CSV file from another application, see that application's documentation.
    • To create a new CSV file, open a new file in a text editor, type email on the first line, type one email address per line on the following lines, then save the file with a .csv extension.

  4. Select Browse files and select your CSV file, or drag and drop the CSV file into the Select a CSV file to upload box. You can select only one CSV file at a time.

  5. After the CSV file uploads, select Review to identify invalid email addresses, invitees with a pending invitation, members already in the organization, or duplicate email addresses in the same CSV file.

  6. Follow the on-screen instructions to invite members.

You can also bulk invite members with the Docker Hub API. For more information, see the Bulk create invites API endpoint.

Pending invitations appear in the Members table. Invitees can accept or decline from the invitation email or the Notifications Center.

Accept an invitation

To accept from the invitation email:

  1. Open the Docker invitation email and select the link to Docker Hub.
  2. The Docker account creation page opens. If you already have an account, select Already have an account? Sign in. If you don't have an account, create one using the same email address that received the invitation.
  3. Optional. If you created a new account, open your email inbox and verify your email address using the Docker verification email.
  4. After you sign in to Docker Hub, select My Hub from the top-level navigation menu.
  5. Select Accept on your invitation.

To accept from the Notifications Center:

  1. Sign in to Docker Hub or Docker Home.
  2. Open the Notifications Center in the header.
  3. Select Accept on the invitation.

After you accept the invitation, you are a member of the organization.

Invitation email links expire after 14 days. If your link has expired, you can still accept from the Notifications Center.

Manage invitations

After inviting members, you can resend or remove invitations. Each invitee occupies one seat. If the number of email addresses in your CSV file exceeds the number of available seats, you can't invite more members.

Tip

Need more seats for your organization? Add seats to your subscription, or see Docker pricing for plan options.

Resend an invitation

You can resend individual or bulk invitations from Docker Home.

To resend an individual invitation:

  1. Sign in to Docker Home and select your organization.
  2. Select Members.
  3. Select the Actions menu next to the invitee, then Resend.
  4. Select Invite to confirm.

To bulk resend invitations:

  1. Sign in to Docker Home and select your organization.
  2. Select Members.
  3. Use the checkboxes next to Usernames to select invitees.
  4. Select Resend invites.
  5. Select Resend to confirm.

Remove an invitation

  1. Sign in to Docker Home and select your organization.
  2. Select Members.
  3. Select the Actions menu next to the invitee, then Remove invitee.
  4. Select Remove to confirm.

Manage members on a team

Use Docker Hub or Docker Home to add or remove team members. Organization owners can add a member to one or more teams within an organization.

Add a member to a team

  1. Sign in to Docker Home and select your organization.
  2. Select Teams.
  3. Select the team name.
  4. Select Add member. Search for the member by email address or username.

An invitee must accept the invitation before you can add them to a team.

Remove members from teams

If your organization uses single sign-on (SSO) with SCIM enabled, remove members from your identity provider (IdP). That removes them from Docker automatically. If SCIM is disabled, remove members manually in Docker using the following steps.

Removing a member from a team revokes their access to that team's permitted resources.

  1. Sign in to Docker Home and select your organization.
  2. Select Teams, then select the team.
  3. Select the X next to the member's name to remove them from the team.
  4. When prompted, select Remove to confirm.

Update a member role

Organization owners can manage roles within an organization. If an organization is part of a company, the company owner can also manage that organization's roles. If SSO is enabled, you can use SCIM for role mapping.

  1. Sign in to Docker Home and select your organization.
  2. Select Members.
  3. Find the username of the member whose role you want to edit. Select the Actions menu, then Edit role.

If you're the only owner of an organization and you want to edit your role, assign a new owner first so you can change your own role.

Remove a member from the organization

Organization owners can remove members from the organization. Removing a member revokes their access to the organization's resources and teams.

If your organization uses SSO with SCIM enabled, remove members from your IdP instead.

  1. Sign in to Docker Home and select your organization.
  2. Select Members.
  3. Find the username of the member you want to remove. Select the Actions menu, then Remove member.
  4. Select Remove to confirm.

Export a member list CSV

Organization owners can export a CSV file of all members. Docker generates the file asynchronously and emails it to the owner when it's ready.

  1. Sign in to Docker Home and select your organization.

  2. Select Members.

  3. Select the Download icon to start the export.

  4. Open the email from Docker and select the link to download the CSV file.

    • Name: The member's name
    • Username: The member's Docker ID
    • Email: The member's email address
    • Type: Whether the entry is a member or an invitee
    • Role: The member's role in the organization
    • Teams: Teams the member belongs to
    • Date Joined: When the member joined the organization

Next steps

After you invite and manage members, explore these related topics: