A database connection error means your website cannot communicate with its database. This guide helps you fix it.
Steps
-
In iPanel, navigate to the Databases tab and verify your database exists and is active.
[screenshot: checking database status]
-
Click on the database to view the connection details: database name, hostname, username, and password.
[screenshot: viewing database connection details]
-
Open your website's configuration file (e.g.,
wp-config.phpfor WordPress) in File Manager.[screenshot: opening config file]
-
Compare the database credentials in the config file with those shown in iPanel. Update any mismatches.
[screenshot: comparing and updating credentials]
-
Verify the database user has the correct permissions for the database.
[screenshot: checking database user permissions]
-
If the database server is on a different host, ensure remote access is enabled.
[screenshot: checking remote access settings]