"Address already in use" error when starting PuppetDB service

When the PuppetDB service starts, you get an Address already in use error.

Error messages and logs

Apr 20 13:44:18 puppetdb: Execution error (BindException) at example.Net/bind0 (Net.java:-2).
Apr 20 13:44:18 puppetdb: Address already in use

You get this error when a port is being used by another app or service. By default, PuppetDB communicates over port 8081. If you have a conflict with another port, check the list of ports used by PE in our firewall documentation for conflicts.

Version and installation information

PE version: All supported versions

Solution

To allow PuppetDB to start, you need to stop the process currently running on port 8081.

To prevent the issue from reoccurring, we recommend that you change the default port for the conflicting third party software. If you can’t do that, you can change the port for PuppetDB.