Compose network documentation: Driver

[mr1chter]

Is this a docs issue?

• My issue is about the documentation content or website

Type of issue

I can't find what I'm looking for

Description

Many examples feature a driver: overlay but the text in the documentation says that host and none are supported. This is mighty confusing. In the next two examples, host and none are used, but for the name attribute. What is this supposed to mean?

Also, the concept of a driver is not explained at all.

Maybe connected to #7439

Location

https://docs.docker.com/compose/compose-file/06-networks/

Suggestion

Maybe it would be great to have just a one-liner or even just a link to the relevant documentation of the network driver concept. This would then also show what "custom drivers" are, that are featured in some of the later examples on the linked page.

As a whole, I'm maybe missing a kind of "default" description. What is set and/or assumed if there is no network section in the compose file?

For context, I'm currently having a situation where docker containers created via compose (no network section in the compose file, single container) can't connect to the internet (meaning ping 8.8.8.8 doesn't work) and I'm completely lost (this might as well also be an issue with my host system setup, not docker, but I haven't figured it out yet).

[aevesdocker]

Hi @mr1chter, thanks for creating the issue. We have an incoming change to address this. #19276

[mr1chter]

This is great, thanks!

[docker-robot]

Closed issues are locked after 30 days of inactivity.
This helps our team focus on active issues.

If you have found a problem that seems similar to this, please open a new issue.

/lifecycle locked