Connect MySQL via cPanel

Jump to

IMPORTANT

Adobe recommends you use SSH or some other form of encryption to secure your data! If this is not an option, you can still directly connect MBI to your database using the instructions in this article.

This article walks you through directly connecting your MySQL database to MBI using cPanel. This process can also be used to connect Adobe Commerce and any other MySQL-based eCommerce databases to MBI.

  1. Create an MBI MySQL user in cPanel
  2. Enter connection and user info into MBI

Get started.

Creating an MBI MySQL user in cPanel

  1. Log in to cPanel via your hosting provider.

  2. Click MySQL Databases, located in the Database section.

  3. Scroll down to the Add New User section and create a user for MBI:

  4. Click Create User.

  5. Now that you have created the user, you need to associate it to a database. Go back to the Add New User section - see the settings for Add User to Database? That is what you need.

  6. In the User dropdown of this section, select the user you created.

  7. In the Database dropdown of this section, select the database you want to connect to MBI.

  8. Click Add.

  9. When the checklist of privileges appears, check the box next to SELECT - this is all MBI needs to connect to your database.

Entering the connection and user info into MBI

To wrap things up, you need to enter the connection and user info into MBI. Did you leave the MySQL credentials page open? If not, go to Manage Data > Connections and click Add New Data Source, then the MySQL icon.

Enter the following info into this page in the Database Connection section:

  • Username: The username for the MBI MySQL user
  • Password: The password for the MBI MySQL user
  • Port: MySQL’s port on your server (3306 by default)
  • Host: The public address of the MySQL server MBI connects to. This is usually the URL that you use to log into cPanel.

If you are using an SSH tunnel, you must enter the encryption information. Set the Encrypted toggle to Yes to display the form.

  • Connection Type: Set this to SSH Tunnel
  • Remote Address: The IP address or hostname of the server MBI will tunnel into
  • Username: The username for the MBI SSH (Linux) user, see instructions on how to do this, if you have not already)
  • SSH Port: SSH port on your server (22 by default)

That is it! When you are finished, click Save & Test to complete the setup.

Related:

On this page