openclaw/docs/install/docker
Micah Abbott 1b9518af27
docs: containerized gateway networking, host model servers, and rootless Podman troubleshooting (#194990)
* docs(podman): reach host model servers from a containerized gateway

Rootless Podman maps host-gateway aliases (host.docker.internal /
host.containers.internal) to a link-local address (169.254.1.2), which
exact-origin SSRF trust excludes, so provider baseUrls built on the
alias are rejected. Document the alias setup and two fixes: use the
host LAN/tailnet IP as the baseUrl, or opt in per provider with
allowPrivateNetwork. Flag the same exception in local-models.

* docs(local-models): add non-interactive hybrid setup recipe

Onboarding configures one provider per run: --custom-* flags are
silently ignored next to a hosted --auth-choice. Document the scripted
sequence — onboard hosted, patch the local provider into config, add
the fallback — running config-mutating steps through the container
once the gateway is up.

* docs(podman): add rootless container troubleshooting

Cover three failure modes observed with a real rootless Quadlet
deployment: config writes rejected by the gateway ownership lock (use
--container or podman exec, wait ~90s after stopping), :Z relabel
failures on root-owned mounts (plain ro instead), and one-off podman
run commands needing --userns=keep-id to match gateway file ownership.

* docs: address ClawSweeper review findings

- podman: use gateway recover-lock instead of heartbeat-wait for stale ownership
- local-models: pipe container config patch via stdin (host --file path not visible)
- podman: qualify that plain ro mount avoids relabel but not SELinux access checks

* docs: qualify Podman host alias networking

Co-authored-by: Micah Abbott <miabbott@redhat.com>
Co-authored-by: miabbott <10236257+miabbott@users.noreply.github.com>
Co-authored-by: Vincent Koc <vincentkoc@ieee.org>
2026-11-13 22:31:11 +08:00
..
compose-operations.md
environment-variables.md feat(browser): support lightweight Docker browser installs (#154608) 2026-10-24 15:20:21 +08:00
networking-and-storage.md docs: containerized gateway networking, host model servers, and rootless Podman troubleshooting (#194990) 2026-11-13 22:31:11 +08:00
sandbox-and-troubleshooting.md