Skip to content

[Docs]: Directory - Add troubleshooting note that Mac machines with Airplay Receiver may conflict with the directory startup #328

@shmcfarl

Description

@shmcfarl

Issue Description

If a Mac user has the AirPlay receiver enabled, it may collide with port 5000 when the user enters "task server:start" as found in the getting started guide:
https://docs.agntcy.org/dir/getting-started/

Colliding Mac AirPlay Service:
Port 5000 is in use by PID 714 (ControlCe).

Error:
task server:start
task: [server:store:pull] docker pull ghcr.io/project-zot/zot-linux-arm64:v2.1.10

v2.1.10: Pulling from project-zot/zot-linux-arm64
44d654bc6e99: Pull complete
bfb59b82a9b6: Pull complete
017886f7e176: Pull complete
62de241dac5f: Pull complete
2780920e5dbf: Pull complete
7c12895b777b: Pull complete
3214acf345c0: Pull complete
5664b15f108b: Pull complete
045fc1c20da8: Pull complete
4aa0ea1413d3: Pull complete
da7816fa955e: Pull complete
ddf74a63f7d8: Pull complete
253e490c8ad8: Pull complete
06730eaeb281: Pull complete
04c23590f9a5: Pull complete
84f0ec4a2d1b: Pull complete
225a015aeda5: Pull complete
Digest: sha256:df36d6180c05bf16cefaa1358dea523e2a87e4389cc59327f2dfc698d8abc7a7
Status: Downloaded newer image for ghcr.io/project-zot/zot-linux-arm64:v2.1.10
ghcr.io/project-zot/zot-linux-arm64:v2.1.10

What's next:
View a summary of image vulnerabilities and recommendations → docker scout quickview ghcr.io/project-zot/zot-linux-arm64:v2.1.10
task: [server:store:start] # mount config
cat > /tmp/config.json <<EOF
{
"distSpecVersion": "1.1.1",
"storage": {
"rootDirectory": "/tmp/zot"
},
"http": {
"address": "0.0.0.0",
"port": "5000"
},
"log": {
"level": "debug"
},
"extensions": {
"search": {
"enable": true
},
"trust": {
"enable": true,
"cosign": true,
"notation": false
}
}
}
EOF

run docker with attached volume

docker run
-it
--rm -d -p 5000:5000
-v /tmp/config.json:/config.json:ro
--name oci-registry ghcr.io/project-zot/zot-linux-arm64:v2.1.10 serve /config.json

f2288d13d3ba890a00ea2c305c20ee9a4b8f407c327d7fab635dda26fc6cba11
docker: Error response from daemon: ports are not available: exposing port TCP 0.0.0.0:5000 -> 127.0.0.1:0: listen tcp 0.0.0.0:5000: bind: address already in use

Run 'docker run --help' for more information
task: [server:store:stop] docker stop oci-registry
Error response from daemon: No such container: oci-registry
task: Failed to run task "server:start": exit status 125

Prposed Solution

A troubleshooting note should be created in the directory getting started guide to help a user disable the AirPlay Receiver as show in the screenshot.

Image

Affected Component

Directory

Checklist

Metadata

Metadata

Labels

No labels
No labels

Type

No type

Projects

Status

In Progress

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions