mirror of https://github.com/docker/docs.git
65 lines
2.4 KiB
Markdown
65 lines
2.4 KiB
Markdown
<!-- This section is included in topics that contain instructions on how to configure registry.json file to enforce users to sign into Docker Desktop-->
|
||
|
||
## 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:
|
||
|
||
```json
|
||
{
|
||
"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:
|
||
|
||
```json
|
||
{
|
||
"allowedOrgs": ["myorg"]
|
||
}
|
||
```
|
||
|
||
3. Open a new terminal and type the following command:
|
||
|
||
```console
|
||
$ sudo mkdir -p /Library/Application\ Support/com.docker.docker
|
||
```
|
||
|
||
If prompted, type your password associated with your local computer.
|
||
|
||
4. Type the following command:
|
||
|
||
```console
|
||
$ sudo cp Documents/registry.json /Library/Application\ Support/com.docker.docker/registry.json
|
||
```
|