Fixing Docker Swarm Communications when using ESXi or vSphere 6.7 as a host

Apparently, when running Docker Swarm on ESXi 6.7 on a rare and specific setup, there is a port conflict on 4789/udp where ESXi would drop packets. Docker Swarm uses port 4789/udp as its default data path port. There are two solutions to avoid this issue. One is to use a different port for Docker Swarm, and the other is to patch your ESXi host; whichever is suitable for your use case.


If this is happening on your machines, you will notice timeouts and connection errors between nodes mostly. You will be able to join the nodes to the swarm and they will appear to connect successfully. There will be no errors telling you that the default port 4789/udp has dropped packets.

Solution 1

docker swarm init --default-addr-pool --data-path-port=14789

Solution 2

You can patch ESXi. More info can be found on this link (PR 2766401):

Leave a Reply

Your email address will not be published. Required fields are marked *

The reCAPTCHA verification period has expired. Please reload the page.