From 75bfd3a5168e27115e3ad07e112f29c91dd053fb Mon Sep 17 00:00:00 2001 From: Josh Bairstow Date: Wed, 3 Jun 2026 00:08:11 +1000 Subject: [PATCH] docs: note Fedora docker0 ZONE_CONFLICT fix for the runner host Co-Authored-By: Claude Opus 4.8 (1M context) --- README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/README.md b/README.md index a47837f..5bc0c18 100644 --- a/README.md +++ b/README.md @@ -170,6 +170,14 @@ sudo snap stop --disable docker.dockerd # if a crashing snap docker is pres sudo systemctl enable --now docker.service # classic engine, on at boot docker info | head # verify as your user, no sudo ``` +Fedora gotcha: if `dockerd` then fails with +`ZONE_CONFLICT: 'docker0' already bound to 'FedoraWorkstation'` (a stale binding, +often left by a prior snap-docker), free the interface and retry: +```sh +sudo firewall-cmd --permanent --zone=FedoraWorkstation --remove-interface=docker0 +sudo firewall-cmd --reload && sudo ip link delete docker0 2>/dev/null +sudo systemctl reset-failed docker.service && sudo systemctl start docker.service +``` ### 6. Wire the jb-website repo In the `jb-website` repo settings on Forgejo (`Settings → Actions`):