Skip to content

Commit 1043de9

Browse files
authored
engine/install: document iptables alternative on Fedora (#24811)
Adds a troubleshooting note on the Fedora install page for the case where the Docker service fails to start with `failed to find iptables` in the logs, pointing users to set the `iptables` alternative to `iptables-nft`. Closes #23186
1 parent 1ad73ff commit 1043de9

File tree

1 file changed

+22
-0
lines changed

1 file changed

+22
-0
lines changed

content/manuals/engine/install/fedora.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -150,6 +150,17 @@ $ sudo dnf config-manager addrepo --from-repofile {{% param "download-url-base"
150150
boot your system. If you don't want Docker to start automatically, use `sudo
151151
systemctl start docker` instead.
152152

153+
> [!NOTE]
154+
>
155+
> If the Docker service fails to start and `journalctl -u docker`
156+
> shows `failed to find iptables`, point the `iptables` command to
157+
> `iptables-nft` using `alternatives` and restart the service:
158+
>
159+
> ```console
160+
> $ sudo alternatives --set iptables /usr/bin/iptables-nft
161+
> $ sudo systemctl restart docker
162+
> ```
163+
153164
3. Verify that the installation is successful by running the `hello-world` image:
154165
155166
```console
@@ -199,6 +210,17 @@ download a new file each time you want to upgrade Docker Engine.
199210
boot your system. If you don't want Docker to start automatically, use `sudo
200211
systemctl start docker` instead.
201212

213+
> [!NOTE]
214+
>
215+
> If the Docker service fails to start and `journalctl -u docker`
216+
> shows `failed to find iptables`, point the `iptables` command to
217+
> `iptables-nft` using `alternatives` and restart the service:
218+
>
219+
> ```console
220+
> $ sudo alternatives --set iptables /usr/bin/iptables-nft
221+
> $ sudo systemctl restart docker
222+
> ```
223+
202224
4. Verify that the installation is successful by running the `hello-world` image:
203225
204226
```console

0 commit comments

Comments
 (0)