✅ Deploy Preview for docsdocker ready!

Name	Link
🔨 Latest commit	f391400
🔍 Latest deploy log	https://app.netlify.com/sites/docsdocker/deploys/64c7d58d18c1370008b11b67
😎 Deploy Preview	https://deploy-preview-17679--docsdocker.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@akerouanton PTAL at these changes for describing the special host-gateway value of --add-host. Also the related CLI pull request, which adds an example for host-gateway-ip dockerd config (maybe there's more to say there?)

I think that https://docs.docker.com/desktop/networking/#i-want-to-connect-from-a-container-to-a-service-on-the-host should also mention host-gateway. For now, it makes it sounds like host.docker.internal and gateway.docker.internal should work out of the box

@iTrooz Because it does work out of the box - but only on Docker Desktop. On Linux, you have to use host-gateway.
Confusing? You bet.

Yeah that those docs linked above are in the Docker Desktop section. Docker Desktop originally introduced the host.docker.internal feature, effectively as workaround for limitations on Desktop that were not present on Linux. However that concept (magic host.docker.internal host) got used by various people, who expected it to also work on Linux.

On Linux, it's more complicated, due to a much wider range of possible setups, where networking can be very different, so it's not possible to set a sensible default. In addition, in production environments it's not always desirable to have the domain added automatically, so on Linux, this feature has to be manually set (there is still a pending ticket to consider having a configurable option for this; docker/cli#2290).

All that said, perhaps it makes sense to move this topic to a more "general" location, update it with "on desktop this is automatic; on Linux, these are the steps to do the equivalent), and to link that section from the current location in the Desktop manual

any thoughts @dvdksn @akerouanton ?