Documentation on Container networks is inconsistent with itself

[BenLyonsGMSL]

Is this a docs issue?

• My issue is about the documentation content or website

Type of issue

Information is incorrect

Description

In https://docs.docker.com/engine/network/#container-networks, it says:

The following flags aren't supported for containers using the container: networking mode:

• ...
• --hostname
• ...

However, it then follows with an example:

$ docker run --rm -it --network container:redis example/redis-cli -h 127.0.0.1

It appears to me that this container is using the container: networking mode and using the --hostname flag (via -h). However, according to the documentation, this is unsupported.

Location

https://docs.docker.com/engine/network/#container-networks

Suggestion

Either --hostname needs to be removed from the list of unsupported flags for the container: networking mode, or the example needs to be corrected. I don't know which is correct.

[thaJeztah]

Thanks for reporting; the example is correct, but can be a bit confusing.

The -h 127.0.0.1 in this case is an argument for the example/redis-cli container, so it's passed as argument to the redis-cli's main process.

Basically the order of flags and arguments is;

docker run [docker run options (flags)] <image name> [command and args for the container]

[BenLyonsGMSL]

Apologies for my misunderstanding, and thank you for the explanation!