Configure single sign-on

Subscription: Business
Requires: Docker Desktop 4.42 and later
For: Administrators

Learn how to set up single sign-on (SSO) for your Docker organization by adding and verifying the domains your members use to sign in.

Step one: Add a domain

Note

Docker supports multiple identity provider (IdP) configurations. You can associate one domain with more than one IdP.

To add a domain:

  1. Sign in to Docker Home and choose your organization. If it's part of a company, select the company first to manage the domain at that level.
  2. Select Admin Console, then Domain management.
  3. Select Add a domain.
  4. Enter your domain in the text box and select Add domain.
  5. In the modal, copy the TXT Record Value provided for domain verification.

Step two: Verify your domain

To confirm domain ownership, add a TXT record to your Domain Name System (DNS) host using the TXT Record Value from Docker. DNS propagation can take up to 72 hours. Docker automatically checks for the record during this time.

Tip

When adding a record name, use @ or leave it empty for root domains like example.com. Avoid common values like docker, docker-verification, www, or your domain name itself. Always check your DNS provider's documentation to verify their specific record name requirements.

  1. To add your TXT record to AWS, see Creating records by using the Amazon Route 53 console.
  2. Wait up to 72 hours for TXT record verification.
  3. After the record is live, go to Domain management in the Admin Console and select Verify.
  1. To add your TXT record to Google Cloud DNS, see Verifying your domain with a TXT record.
  2. Wait up to 72 hours for TXT record verification.
  3. After the record is live, go to Domain management in the Admin Console and select Verify.
  1. To add your TXT record to GoDaddy, see Add a TXT record.
  2. Wait up to 72 hours for TXT record verification.
  3. After the record is live, go to Domain management in the Admin Console and select Verify.
  1. Sign in to your domain host.
  2. Add a TXT record to your DNS settings and save the record.
  3. Wait up to 72 hours for TXT record verification.
  4. After the record is live, go to Domain management in the Admin Console and select Verify.

Next steps