Skip to content

Port Conflicts


During configuration the script exits with an error like the following:

ERROR: for plex cannot start service plex: driver failed programming external connectivity on endpoint plex (5a4d78fd5ff6c4c1a978ef31): Error starting userland proxy: listen udp bind: address already in use ERROR: Encountered errors while bringing up the project. 2019-02-13 17:38:19 [FATAL] Docker Compose failed.

This is due to another service that has occupied that port disallowing DockSTARTer from installing a service on that port.

Troubleshooting Methods

As DockSTARTer will check and fail if another service is occupying the port, it is necessary to locate and deal with the conflict.

One way is to locate the service currently occupying the port. You can do the following:

# sudo netstat -ltunp | grep -w ':<port>'
## Example:
sudo netstat -ltunp | grep -w ':8080'

Once you locate the offending service then you can choose what to do.


Example: If you have avahi-daemon installed this will conflict with udp/5353 port usage for iTunes in Plex if selected. This will cause the script to exit with an [ERROR] and a [FATAL].

One resolution is to change the port being bound during configuration. During configuration change the external port exposed from 5353 to 5354 (or another unused port). This will resolve the conflict.

Another resolution would be to remove the software that is in conflict. Again as the example above. If you are not using mDNS resolution then avahi-daemon would be unnecessary. Simply remove the package with apt remove avahi-daemon from the base server. This will remove the offending service and allow the port to be used by the Docker service.