Configure single sign-on

Get started creating a single sign-on (SSO) connection for your organization or company. This guide walks through the steps to add and verify the domains your members use to sign in to Docker.

Step one: Add your domain


Early Access

The Docker Admin Console is an early access product.

It's available to all company owners and organization owners. You can still manage organizations in Docker Hub, but the Admin Console includes company-level management and enhanced features for organization management.

  1. Sign in to the Admin Console.
  2. Select your organization or company from the left-hand drop-down menu. Note that when an organization is part of a company, you must select the company and configure the domain for the organization at the company level.
  3. Under Security and access, select Domain management.
  4. Select Add a domain.
  5. Enter your domain in the text box and select Add domain.
  6. The pop-up modal will prompt you with steps to verify your domain. Copy the TXT Record Value.
  1. Sign in to Docker Hub.
  2. Select Organizations and then your organization from the list.
  3. On your organization page, select Settings and then Security.
  4. Select Add a domain.
  5. Enter your domain in the text box and select Add domain.
  6. The pop-up modal will prompt you with steps to verify your domain. Copy the TXT Record Value.

Step two: Verify your domain

Verifying your domain ensures Docker knows you own it. Domain verification is done by adding your Docker TXT Record Value to your domain host. The TXT Record Value proves ownership, which signals the Domain Name System (DNS) to add this record. It can take up to 72 hours for DNS to recognize the change. When the change is reflected in DNS, Docker will automatically check the record to confirm your ownership.


Early Access

The Docker Admin Console is an early access product.

It's available to all company owners and organization owners. You can still manage organizations in Docker Hub, but the Admin Console includes company-level management and enhanced features for organization management.

  1. Navigate to your domain host, create a new TXT record, and paste the TXT Record Value from Docker.
  2. TXT record verification can take 72 hours. Once you have waited for TXT record verification, return to the Domain management page of the Admin Console and select Verify next to your domain name.
  1. Navigate to your domain host, create a new TXT record, and paste the TXT Record Value from Docker.
  2. TXT Record Verification can take 72 hours. Once you have waited for TXT record verification, return to the Security page of Docker Hub and select Verify next to your domain name.

Once you have added and verified your domain, you are ready to create an SSO connection between Docker and your identity provider (IdP).

More resources

The following videos walk through verifying your domain to create your SSO connection in Docker.

What's next?

Connect Docker and your IdP.