opensource/podman
1
0
Fork 0
mirror of https://github.com/containers/podman.git synced 2025-08-06 19:44:14 +08:00
Code Issues Packages Projects Releases Wiki Activity

Mention no_hosts and base_hosts_file configs in CLI option docs

Browse Source 
Follow-up to #24043

Signed-off-by: Daniel Rudolf <github.com@daniel-rudolf.de>
This commit is contained in:
Daniel Rudolf
2024-10-02 23:15:24 +02:00
parent ded7833255
commit 6f9cc3755a
2 changed files with 14 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
docs/source/markdown/options/add-host.md
View File

@ -11,7 +11,8 @@ a single IPv4 or IPv6 address, separated by a colon. It can also be used to
overwrite the IP addresses of hostnames Podman adds to `/etc/hosts` by default overwrite the IP addresses of hostnames Podman adds to `/etc/hosts` by default
(also see the **--name** and **--hostname** options). This option can be (also see the **--name** and **--hostname** options). This option can be
specified multiple times to add additional mappings to `/etc/hosts`. It specified multiple times to add additional mappings to `/etc/hosts`. It
conflicts with the **--no-hosts** option. conflicts with the **--no-hosts** option and conflicts with *no_hosts=true* in
`containers.conf`.
Instead of an IP address, the special flag *host-gateway* can be given. This Instead of an IP address, the special flag *host-gateway* can be given. This
resolves to an IP address the container can use to connect to the host. The resolves to an IP address the container can use to connect to the host. The
@ -26,4 +27,13 @@ You can prevent that by either giving the **--no-hosts** option, or by setting
*host_containers_internal_ip="none"* in *containers.conf*. If no *host-gateway* *host_containers_internal_ip="none"* in *containers.conf*. If no *host-gateway*
address was configured manually and Podman fails to determine the IP address address was configured manually and Podman fails to determine the IP address
automatically, Podman will silently skip adding these internal hostnames to automatically, Podman will silently skip adding these internal hostnames to
`/etc/hosts`. `/etc/hosts`. If Podman is running in a virtual machine using `podman machine`
(this includes Mac and Windows hosts), Podman will silently skip adding the
internal hostnames to `/etc/hosts`, unless an IP address was configured
manually; the internal hostnames are resolved by the gvproxy DNS resolver
instead.
Podman will use the `/etc/hosts` file of the host as a basis by default, i.e.
any hostname present in this file will also be present in the `/etc/hosts` file
of the container. A different base file can be configured using the
*base_hosts_file* config in `containers.conf`.

3
docs/source/markdown/options/no-hosts.md
View File

@ -12,4 +12,5 @@ hostname (see **--hostname** option), the internal `host.containers.internal`
and `host.docker.internal` hosts, as well as any hostname added using the and `host.docker.internal` hosts, as well as any hostname added using the
**--add-host** option. Refer to the **--add-host** option for details. Passing **--add-host** option. Refer to the **--add-host** option for details. Passing
**--no-hosts** disables this, so that the image's `/etc/hosts` file is kept **--no-hosts** disables this, so that the image's `/etc/hosts` file is kept
unmodified. unmodified. The same can be achieved globally by setting *no_hosts=true* in
`containers.conf`.