github.com/containers/podman/v5@v5.1.0-rc1/docs/source/markdown/options/network-alias.md (about)

     1  ####> This option file is used in:
     2  ####>   podman create, pod create, run
     3  ####> If file is edited, make sure the changes
     4  ####> are applicable to all of those.
     5  #### **--network-alias**=*alias*
     6  
     7  Add a network-scoped alias for the <<container|pod>>, setting the alias for all networks that the container joins. To set a
     8  name only for a specific network, use the alias option as described under the **--network** option.
     9  If the network has DNS enabled (`podman network inspect -f {{.DNSEnabled}} <name>`),
    10  these aliases can be used for name resolution on the given network. This option can be specified multiple times.
    11  NOTE: When using CNI a <<container|pod>> only has access to aliases on the first network that it joins. This limitation does
    12  not exist with netavark/aardvark-dns.