discussion Guide cPanel cPanel Error: “The Database Server is Currently Offline” and DBCACHE: exit 255

[CL4Y]

While performing database operations through cPanel, you may encounter one of the following errors:

The database server is currently offline.

or

adminbin Cpanel/cpmysql/DBCACHE: exit 255

These errors typically occur when cPanel fails to read the MySQL database configuration or when data corruption/missing entries exist.
To fix this issue, you can use the /scripts/rebuild_dbmap command to rebuild cPanel’s database mapping (DB Map).

---

🔧 Step-by-Step Solution​

✅ 1. Connect to the Server via SSH as root​

✅ 2. Rebuild the cPanel User’s Database Map​

In the command below, replace “Username” with your actual cPanel account username:

/scripts/rebuild_dbmap Username

This command allows cPanel to re-detect all database users and their associated databases.

---

🔁 Alternative: Restart the MySQL Service if Needed​

If the issue persists after rebuilding the DB map, try restarting the MySQL service:

service mysql restart

or

systemctl restart mysqld

 

[CL4Y]

After these steps, database operations in cPanel (phpMyAdmin, database creation/deletion, user assignment, etc.) will return to normal. The issue is largely caused by corrupted DB mappings, and the rebuild_dbmap command fixes this.

However, if the problem persists, please provide us with more information.

 

[ajin]

That error usually appears when MySQL or MariaDB service on your cPanel server is stopped, misconfigured, or facing corruption. Start by checking the MySQL service status via WHM or SSH using systemctl status mysql or service mysql status. If it’s not running, try restarting it with service mysql restart.


Also, look at the MySQL error log (/var/lib/mysql/hostname.err) — if you see page corruption or InnoDB-related errors, it means the database might be damaged. In such cases, repair tools like Stellar Repair for MySQL can help recover corrupted databases and get your cPanel MySQL service running again.