## Create a registry.json file Before creating a `registry.json` file, ensure that the user is a member of at least one organization in Docker Hub. If the `registry.json` file matches at least one organization the user is a member of, they can sign in to Docker Desktop and access all their organizations. Based on the user's operating system, you must create a `registry.json` file at the following location and make sure the file can't be edited by the user: - Windows: `/ProgramData/DockerDesktop/registry.json` - Mac: `/Library/Application Support/com.docker.docker/registry.json` The `registry.json` file must contain the following contents, where `myorg` is replaced with your organization's name. ```json { "allowedOrgs":["myorg"] } ``` You can use the following methods to create a `registry.json` file based on the user's operating system.
### Windows On Windows, you can use the following methods to create a `registry.json` file. #### Create registry.json when installing Docker Desktop on Windows To automatically create a `registry.json` file when installing Docker Desktop, download `Docker Desktop Installer.exe` and run one of the following commands from the directory containing `Docker Desktop Installer.exe`. Replace `myorg` with your organization's name. If you're using PowerShell: ```powershell PS> Start-Process '.\Docker Desktop Installer.exe' -Wait install --allowed-org=myorg ``` If you're using the Windows Command Prompt: ```console C:\Users\Admin> "Docker Desktop Installer.exe" install --allowed-org=myorg ``` #### Create registry.json manually on Windows To manually create a `registry.json` file, run the following PowerShell command as an Admin and replace `myorg` with your organization's name: ```powershell PS> Set-Content /ProgramData/DockerDesktop/registry.json '{"allowedOrgs":["myorg"]}' ``` This creates the `registry.json` file at `C:\ProgramData\DockerDesktop\registry.json` and includes the organization information the user belongs to. Make sure this file can't be edited by the user, only by the administrator.
### Mac On Mac, you can use the following methods to create a `registry.json` file. #### Create registry.json when installing Docker Desktop on Mac To automatically create a registry.json file when installing Docker Desktop, download `Docker.dmg` and run the following commands in a terminal from the directory containing `Docker.dmg`. Replace `myorg` with your organization's name. ```console $ sudo hdiutil attach Docker.dmg $ sudo /Volumes/Docker/Docker.app/Contents/MacOS/install --allowed-org=myorg $ sudo hdiutil detach /Volumes/Docker ``` #### Create registry.json manually on Mac To manually create a `registry.json` file, run the following commands in a terminal and replace `myorg` with your organization's name. ```console $ sudo mkdir -p "/Library/Application Support/com.docker.docker" $ echo '{"allowedOrgs":["myorg"]}' | sudo tee "/Library/Application Support/com.docker.docker/registry.json" ``` This creates (or updates, if the file already exists) the `registry.json` file at `/Library/Application Support/com.docker.docker/registry.json` and includes the organization information the user belongs to. Make sure the file has the expected content and can't be edited by the user, only by the administrator. Verify that the content of the file contains the correct information; ```console $ sudo cat "/Library/Application Support/com.docker.docker/registry.json" {"allowedOrgs":["myorg"]} ``` Verify that the file has the expected permissions (`-rw-r--r--`) and ownership (`root` and `admin`): ```console $ sudo ls -l "/Library/Application Support/com.docker.docker/registry.json" -rw-r--r-- 1 root admin 26 Jul 27 22:01 /Library/Application Support/com.docker.docker/registry.json ```