Valid for versions 106 through the latest version
Last modified: July 8, 2022
Overview
Use this interface to create, manage, and delete MySQL® databases and database users.
- This interface is experimental and is not fully functional. It only appears if you created the
/var/cpanel/experimental/mysql_managertouch file. - Don’t use phpMyAdmin to create databases or database users. phpMyAdmin doesn’t map databases, which causes backups and restorations to not function.
The cPanel & WHM implementation of MySQL and MariaDB® uses modified character limits for database names and database usernames:
Use the Force short prefix for MySQL and MariaDB databases setting in WHM’s Tweak Settings interface (WHM » Home » Server Configuration » Tweak Settings) to limit the database prefix to eight characters. For more information about MySQL and MariaDB prefix settings, read our Tweak Settings documentation.
Enabling the Force short prefix for MySQL and MariaDB databases setting in WHM’s Tweak Settings interface (WHM » Home » Server Configuration » Tweak Settings) will prevent you from creating new accounts that share the same first 8 characters of their usernames.
The Databases tab
The Databases tab lists the databases owned by your cPanel account. To sort the database, click Database Name, Size, or Database User to reorder the Database table.
Create a Database and a Database User
The MySQL Manager interface will load the Create Database interface if your account does not have a database.
If your cPanel account already has a database, click Create Database to open the Create Database interface.
To create a database and database user, perform the following steps:
- In the Database Name text box, enter a name for the database.
- Click the Create Database user toggle to create a database user.
- The interface will automatically enter a database username in the Database Username text box.
- You can change the username in the Database Username text box. However, the system’s character modified limits still apply.
- The interface will automatically assign the Select, Insert, Update, and Delete database privileges.
- For more information about user privileges, read the MySQL documentation.
- The interface will automatically enter a database username in the Database Username text box.
- Click Create.
- If you wish to create multiple databases, click the Stay on this page to create another database checkbox.
- Otherwise, the system will load the Databases table and your database will appear in the table.
View
The database table displays the following information for each database:
- Database Name — The name of the database.
- Size — The size of the database in bytes.
- Database Users — The database users that you assigned permissions for the database.
Actions
You can use the following features for each database:
- Manage — Change a database name.
- To rename a database, click Manage. A new interface will appear. In the Database Name text box, enter the new database name and click Update to update the database name or Go Back to cancel.
- Delete — Delete the database.
- To delete a database, click Delete. A confirmation message will appear. Click Delete to delete the database or click Cancel.
The Database Users tab
This function is not yet implemented.
The Configuration tab
This function is not yet implemented.
