Skip to content

Commit 47b5137

Browse files
committed
engine/security/rootless/troubleshoot: fix "Historical limitations"
"`IPAddress` shown in `docker inspect` is unreachable" is not a historical limitation and still holds true in Docker Engine v29.5 and later. When I wrote this section, I probably confused the topic with the source IP address propagation issue with `docker run -p` which is fixed in Docker Engine v29.5. Follow-up to PR 24645 Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
1 parent 692f368 commit 47b5137

1 file changed

Lines changed: 8 additions & 5 deletions

File tree

content/manuals/engine/security/rootless/troubleshoot.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -77,15 +77,18 @@ weight: 30
7777
- Exposing SCTP ports
7878
- To use the `ping` command, see [Routing ping packets](./tips.md#routing-ping-packets).
7979
- To expose privileged TCP/UDP ports (< 1024), see [Exposing privileged ports](./tips.md#exposing-privileged-ports).
80+
- `IPAddress` shown in `docker inspect` is namespaced inside RootlessKit's network namespace.
81+
This means the IP address is not reachable from the host without `nsenter`-ing into the network namespace.
82+
- Port forwarding with `docker run -p` does not propagate source IP addresses by default.
83+
See [`docker run -p` does not propagate source IP addresses](#docker-run--p-does-not-propagate-source-ip-addresses) to enable source IP propagation.
8084
- NFS mounts as the docker "data-root" is not supported. This limitation is not specific to rootless mode.
8185

8286
### Historical limitations
8387

8488
#### Until Docker Engine v29.5
8589

86-
- `IPAddress` shown in `docker inspect` is namespaced inside RootlessKit's network namespace.
87-
This means the IP address is not reachable from the host without `nsenter`-ing into the network namespace.
88-
- Host network (`docker run --net=host`) is also namespaced inside RootlessKit.
90+
- Host network (`docker run --net=host`) was namespaced inside RootlessKit.
91+
This meant that ports listened by containers with `--net=host` were not reachable from the real host network namespace.
8992

9093
## Troubleshooting
9194

@@ -280,8 +283,8 @@ For details, see [Routing ping packets](./tips.md#routing-ping-packets).
280283

281284
#### `IPAddress` shown in `docker inspect` is unreachable
282285

283-
This was an expected behavior until Docker Engine v29.5, as the daemon was namespaced inside RootlessKit's
284-
network namespace. Use `docker run -p` instead, or upgrade to Docker Engine v29.5 or later.
286+
This is an expected behavior, as the daemon is namespaced inside RootlessKit's
287+
network namespace. Use `docker run -p` instead.
285288

286289
#### `--net=host` doesn't listen ports on the host network namespace
287290

0 commit comments

Comments
 (0)