docker-py does not return the host-address when using ssh transport

I checked the way docker-py api works when using local docker or remote docker (swarm or not) and I failed to find where it would return the host-address of the running container.

Returning "0.0.0.0" has zero value to the application using docker-py because that 0.0.0.0 may not be application localhost if DOCKER_HOST variable points to a remote machine.

I asked this question on Slack and stackoverflow but without any answers so far.

It seems that now the docker-py application would be forced to parse the DOCKER_HOST variable itself, look if it can extract a hostname out of it and use it, with a fallback to localhost. This seems as a very bad practice that is likely to break in many scenarios.

The IP or hostname of the machine running the container should be returned by docker-api itself.

I tried to get some information out of docker.info() but Name is unreliable as on one machine it happened to be the right hostname but on a machost it returned the name of the linuxvm running docker, clearly not something that was addresable/accesible. There was also the ['Swarm'].['NodeAddr'] which was looking ok in one case but it was empty in others.

I think that the application itself should not be aware of DOCKER_HOST and that the host-address should be returned/exposed by the docker-py api.

Start by tracing the docker-py API path for SSH transport and compare it with the docker.info() and Swarm NodeAddr values mentioned in the issue; also inspect how DOCKER_HOST is currently interpreted. Done means the API exposes a reliably addressable host address for containers reached through SSH transport without requiring applications to parse DOCKER_HOST, with behavior defined for the described cases.