docs/_includes/configure-registry-json.md

Create a registry.json file

After you’ve successfully installed Docker Desktop, create a registry.json file. Before you create a registry.json file, ensure that the developer is a member of at least one organization in Docker Hub. If the registry.json file matches at least one organization the developer is a member of, they can sign into Docker Desktop, and then access all their organizations.

Windows

On Windows, you must create a file at C:\ProgramData\DockerDesktop\registry.json with file permissions that ensure that the developer using Docker Desktop cannot remove or edit the file (that is, only the system administrator can write to the file). The file must be of type JSON and contain the name of the organization in the allowedOrgs key.

To create your registry.json file on Windows:

1. Open Windows PowerShell and select Run as Administrator.

2. Type the following command cd /ProgramData/DockerDesktop/

3. Type notepad registry.json and enter the name of the Docker Hub organization that the developer belongs to in the allowedOrgs key and click Save. For example:

   {
       "allowedOrgs": ["myorg"]
   }
   

Mac

On macOS, you must create a file at /Library/Application Support/com.docker.docker/registry.json with file permissions that ensure that the developer using Docker Desktop cannot remove or edit the file (that is, only the system administrator can write to the file). The file must be of type JSON and contain the name of the Docker Hub organization names in the allowedOrgs key.

To create your registry.json file on macOS:

1. Navigate to VS Code or any text editor of your choice.

2. Enter the name of the Docker Hub organization that the developer belongs to in the allowedOrgs key and save it in your Documents. For example:

   {
       "allowedOrgs": ["myorg"]
   }
   

3. Open a new terminal and type the following command:

   sudo mkdir -p /Library/Application\ Support/com.docker.docker
   

   If prompted, type your password associated with your local computer.

4. Type the following command:

   sudo cp Documents/registry.json /Library/Application\ Support/com.docker.docker/registry.json