Symptoms

When integrating Bitbucket Server with PostgreSQL 9, the connection with the database is refused and you see a reported exception similar to this:

org.apache.commons.dbcp.SQLNestedException: Cannot create PoolableConnectionFactory (FATAL: password authentication failed for user "<username>")

Cause

This problem is caused because Bitbucket Server has not been added to the PostgreSQL pg_hba.conf file, without which PostgreSQL 9 will not allow the connection.

Resolution

Add Bitbucket Server to the PostgreSQL pg_hba.conf file, so that PostgreSQL 9 will allow bitbucket to connect. The pg_hba.conf file enables client authentication between the PostgreSQL server and a client application, such as Bitbucket Server. The file defines a database host and its associated permissions (for example, the database it is allowed to connect to, the authentication method to use, and so on). For details of the file contents, see the PostgreSQL documentation at http://www.postgresql.org/docs/9.2/static/auth-pg-hba-conf.html.