PostgreSQL: "java.sql.SQLException: No suitable driver found"

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Problem

JIRA setup wizard in browser throws "No suitable driver found" error when attempting to connect to PostgreSQL database

Cause

There are two possible causes for this error.

  1. JDBC driver is not loaded:

    Ensure that the PostgreSQL driver is located in the correct directory which should be in "JIRA Install/lib".Usually this is not an issue as the driver is bundled along with JIRA.

    (Auto-migrated image: description temporarily unavailable)
  2. JDBC URL is in wrong syntax:

    Entering the wrong JDBC URL syntax will also throw the same error, as illustrated in this example below where http:// protocol is accidentally specified when copy & pasting the hostname.

    (Auto-migrated image: description temporarily unavailable)
Updated on April 11, 2025

Still need help?

The Atlassian Community is here for you.