Troubleshooting Database Connectivity from the Jamf Pro Server

Technical Articles

Solution
Application
Content Type
Technical Documentation
Utilities & Services
ft:locale
en-US

During startup, an error message appears indicating that Jamf Pro cannot establish a connection to the database.

This error occurs when the Jamf Pro server is unable to connect to the MySQL database when accessing the web interface. One or more of the following issues may explain the error:

  • The database connection details are not configured.

  • MySQL is not running on the database server.

  • The DataBase.xml file contains invalid MySQL server location details.

  • The database server is not accepting incoming connections.

  • The DataBase.xml file contains invalid user credentials.

  • The database user is not granted proper privileges to the database.

  • The database user password authentication plug-in is not properly configured.

Each of these potential issues are detailed below with steps to verify and resolve.
Note:

If the database connection error persists after trying these options to resolve, contact Jamf Support.