docs/docker-hub/onboard-business.md

6.2 KiB
Raw Blame History

description keywords title toc_min toc_max
Docker Business onboarding business, organizations, get started, onboarding Docker Business onboarding 1 2

The following section contains step-by-step instructions on how to get started onboarding your organization after you obtain a Docker Business subscription.

Prerequisites

Before you start to on board your organization, ensure that you've completed the following:

  • You have a Docker Business subscription. You can verify your subscription in Docker Hub's Billing Details{: target="blank" rel="noopener" class=""}. If you haven't subscribed to Docker Business yet, see Upgrade your subscription for details about upgrading.
  • Your Docker Business subscription is new. If you upgraded your Docker Team subscription or renewed your Docker Business subscription, see what's next.
  • Your Docker Business subscription has started. You can't complete all the steps until after your subscription start date.
  • You are familiar with Docker terminology. If you discover any unfamiliar terms, see the glossary or FAQs.

Step 1: Identify your Docker users and their Docker accounts

To begin, you should identify which users you will need to add to your Docker Business organization. Identifying your users will help you efficiently allocate your subscription's seats and manage access.

  1. Identify the Docker users in your organization.
    • If your organization uses device management software, like MDM or JAMF, you may use the device management software to help identify Docker users. See your device management software's documentation for details. You can identify Docker users by checking if Docker Desktop is installed at the following location on each user's machine:
      • Mac: /Applications/Docker.app
      • Windows: C:\Program Files\Docker\Docker
      • Linux: /opt/docker-desktop
    • If your organization doesn't use device management software, you may survey your users.
  2. Instruct all your Docker users in your organization to update their existing Docker account's email address to an address that's in your organization's domain, or to create a new account using an email address in your organization's domain.
    • To update an account's email address, instruct your users to sign in to Docker Hub{: target="blank" rel="noopener" class=""}, go to Account Settings{: target="blank" rel="noopener" class=""}, and update the email address to their email address in your organization's domain.
    • To create a new account, instruct your users to go sign up{: target="blank" rel="noopener" class=""} using their email address in your organization's domain.
  3. Ask your Docker sales representative to provide a list of Docker accounts that use an email address in your organization's domain.

Step 2: Invite owners

Now that you have a Docker Business organization, it's time to start adding owners to help you set up and manage your organization. Owners can add or remove members, and configure Single Sign-on as well as other security settings.

To add an owner, invite a user to the owners team. For more details, see Invite members{: target="blank" rel="noopener" class=""}.

Step 3: Invite members

Add members to your organization using a CSV file, or by entering their email addresses. For more details, see Invite members{: target="blank" rel="noopener" class=""}

Step 4: Manage members with SSO and SCIM

Automate adding members to your organization using the following:

  • Single Sign-on: Automatically provision and add members when they sign in to Docker Hub through your identity provider. For details, see Single Sign-on overview.
  • System for Cross-domain Identity Management: Automatically provision, add, and de-provision members from your identity provider. For details, see SCIM.

Step 5: Enforce sign-in for Docker Desktop

By default, members of your organization can use Docker Desktop on their machines without signing in to any Docker account. To ensure that a user signs in to a Docker account that is a member of your organization and that the organizations settings apply to the users session, you can use a registry.json file. For details, see Configure registry.json to enforce sign-in{: target="blank" rel="noopener" class=""}.

What's next

Configure security settings and manage your repositories:

  • Create repositories to share container images.
  • Move images from your personal account to your organization.
  • Create teams and configure repository permissions.
  • Configure Hardened Docker Desktop to improve your organizations security posture for containerized development. Hardened Docker Desktop includes:
  • Audit your domains to identify Docker users who have authenticated to Docker using an email address associated with one of your verified domains, but theyre not a member of your organization in Docker.

Your Docker Business subscription provides many more additional features. Learn more.