How to Connect to a Database with MySQL Workbench

One tool you can use to connect to remotely connect to databases on your shared, VPS, or Dedicated hosting account is MySQL Workbench. MySQL Workbench is a free tool you can use to connect to your server databases from your personal computer. MySQL Workbench can be Downloaded for free at the following link:

You will want to use the Windows (x86, 32-bit), MSI Installer if you are on Windows. The file we are installing in this tutorial is the mysql-workbench-gpl-5.2.47-win32.msi file.

Once you have downloaded MySQL Workbench, you can install it onto your computer. After you have the program installed, follow the steps below to set up a remote connection.

Add IP to your Remote MySQL

In order for you to be able to connect to your databases remotely you will need to add your local computer IP address to the Remote MySQL in cPanel. You can get your IP address by going to the following link:

What’s My IP address?

Steps to connect to your database remotely

  1. Open MySQL Workbench.
  2. Click New Connection towards the bottom left of MySQL Workbench.

    New Connection MySQL Workbench

  3. In the “Set up a New Connection Dialogue” box, Type your Database connection credentials. The credentials will be like the following:

    Connection Name: You can name this whatever you like.
    Connection Method: Standard (TCP/IP).
    Hostname: You can use your domain our your cPanel IP address.
    Port: 3306
    Username: Your cPanel username or the user you created for the database.
    Password: cPanel password or the password for the database user that was created.
    Default Schema: This can be left blank.

    Click Test Connection.

    Test Connection MySQL Workbench

  4. Type your password and click the “Save Password in Vault” check box.

    Click Ok.

    Enter password MySQL Workbench

  5. MySQL Workbench should say “Connection parameters are correct“. Click Ok.

    Correect connetion MySQL Workbench

  6. Click Ok again to accept the connection settings.

    Click ok MySQL Workbench

  7. Now under the SQL Development section you will see your connection listed in the Open Connection to Start Querying box. Click your newly created account.

    Open Connetion MySQL Workbench

    Now you will see the databases list in the area on the left.

    View Databases in MySQL Workbench

Thoughts on “How to Connect to a Database with MySQL Workbench

  • Hi.. I have login to windows administrator and connect to remote SQL server but if i login to non-administrator account then not able to connect to remote sql server.

    please help

    • I’d advise trying to use your cPanel login credentials. This should provide you with the necessary access.

  • HI I have a question is that for the server only ?

    if YES then what step am i going to set for the other pc  that is connected with the same hotspot with the server?

  • Hi

    Thanks for the detailed explanation.

    When I try to connect to MySQL I’m getting below error.

    “Connect failed: Access denied for user ‘root’@’localhost’ (using password: YES)”

    I downloaded the latest version of both Mysql server and Workbench which is 8.0

    Please let me know what wrong I am doing here.

    • It looks like a typical user/password combination error. Are you certain you’re using the correct password? Remember the MySQL root password may be different from the server root user password. I’d advise resetting the password to be sure.

  • 2- I am getting an error when connecting to an existing remote database (I think it is rev 4.5): “Failed to Connect to MySQL at ASHSxxxxx:3306 with user root. Malformed packet”.

    What can I do to make it work? Other than upgrading the DB (I cannot do that at this time).

  • hi

    i had a problem in making database .it needs connection and when i try to make connection then it ask for host name i dont under stand what to write in host name . kinly tell me the solution so i make database.

  • I am able to connect, but I get a connection warning. It says:


    Incompatible/nonstandard server version or connection protocol detected (10.1.32)


    A connection to this database can be established but some MySQL Workbench features may not work properly since the database is not fully compatible with the supported versions of MySQL.

    MySQL Workbench is developed and tested for MySQL server versions 5.6, 5.7, and 8.0

    Is there a way to update the SQL version on my inmotion server account?

  • I hvae a database on my local PC that I would like to move to a network drive/folder and access it there from my PC.  How do I get the database to the network folder so it’s usable from my PC?


    • Depending on the type of database you’re using, you should be able to export the database. If you want to use the database server available with our hosting services, then you will need to use our MySQL server. If you can export the database into a base format such as CSV or XML, then you should able to move your database from your local PC to the server database. The application you would use to import the CSV file into the database would phpMyAdmin. Please see this article on how to use phpMyAdmin to import a database.

  • Hello – Am not able to connect Workbench to the SQLExpress db engine installed on my laptop’s Windows 7 Professional hard drive.

    Have successfully connected to the db engine with SQL Server Mgmt Studio, run queries, etc.

    In Workbench, I do not know which Connection Method to use, and have tried filling in variations of SSMS’s connection properties with no luck. (They are Server Name: DACERP645MG\SQLEXPRESS; Authentication: Windows; User Name: DACERP645MG\Deirdre; Connect to database: <default>….)

    Windows 7 has no password. I have tried creating the Workbench connection with Mgmt Studio running / connected, and without.

    All help greatly appreciated!  Thanks, Dee

    BEGINNING: On Sept 7, 2017, I installed both MS SQLServer Express, Mgmt Studio and prerequisite tools – to their default paths. Seven days later I installed Workbench. Windows User Profiles (all Type Local):

    DACERP645MG\Deirdre – Administrator


    Have tried different online suggestions:  With my service provider’s IP address (Host 127.00.01; Port 3306), Workbench loads with Service Status: Stopped. Start Sever brings log message f Cannot connect to MySQL server on ‘127.00.01’ (10061) (2003).  Connection properties that display are – Host: n/a; Socket: n/a; Port: n/a; Version: n/a; Compiled For: n/a (n/a); Configuration File:  C:\Program Data\MySQL\MySQL Server 5.5\my.ini – which does not exist.

    Have searched for SQL Server-related *.ini files I both C:\Program Files\, C:\Program Files (x86)\. Also searched C:\ for *.ini, by Date Modified and found only long file names in C:\Program Files\Microsoft SQL Server\MSSQL12.SQLEXPRESS\MSSQL\Binn and C:\Windows\inf\MSSQL$SQLEXPRESS\0009.


    SERVICES:  Both services SQL Server (SQLEXPRESS) and SQL Server (SQLSRVEXPR) are Started and Automatic. When I try to start SQL Server Agent (SQLEXPRESS) and SQL Server Agent (SQLSRVEXPR), I get the message that “… service on Local Comptuer started and then stopped. Some services stop automatically if they are no in use by other services or programs.”

    • It is difficult to troubleshoot your local environment since we do not have access or know how it was configured. But, I recommend checking your server’s logs for records of the connection. Also, check your firewall and port settings to ensure they allow incoming MySQL connections.

      Thank you,

  • Nice post! This is really helpful. Its nice information for WordPress users. This is really helpful to used my business site developement.


  • Hi,

    I was working on a website and want to get the PHP portion of it working. Does Mysql Workbench serve as a web hosting server as well? If so, what is the general directory where I would have to say my files. Also if there are any special configurations I would need setup prior.


    • Unfortunately, no, MySQL Workbench is just a database client. It’s basically an application that connects to a database and provides some helpful management tools. You will still need a web server or hosting account with PHP and database software like MySQL or MariaDB installed.

    • Hello Louis,

      Thanks for using our tutorial! If you have any further questions or comments, please let us know.

      Arnel C.

  • I have been able to link to my database and seel all my tables, but I am getting an error when I try to creat or edit a table. “ERROR 1044: Access denied for user …” Im not sure where im missing allowing access to my database?

  • One question , and it is one that I cannot seem to get a clear answer to. If I install MySql workbench on a windows client can I do a remote connection to a backend MySql database sitting on a Linux RedHat Server ??

    • Hello Joseph,

      I can answer this question in respect to our hosting servers which use a flavor of Linux called CENTOS. As per the article above, you can create a remote connection to allow the database client to connect to the database. I’m not sure if it would be any different with your Linux Redhat server.

      If you have any further questions or comments, please let us know.

      Arnel C.

  • I was looking for the database server hostname, excecuting this from the myPhpAdmin solved the problem:

    SHOW VARIABLES WHERE Variable_name = 'hostname'
  • Hi excuse me I created a php file for working with MySQL Workbench. I searched in internet that when one is using XAMPP for example you will need to place the file in the “C:\xampp\htdocs” directory (or if your XAMPP install directory is different use that directory\htdocs). For MySQL Workbench where do I need to place my php file?

    • Hello Sebastian,

      Apologies for the confusion with MySQL workbench. We can provide support for the software as it applies to hosted servers. However, your issue has to do with placement or location of a file on a local computer hard drive. You will need to review the MySQL Workbench documentation for details on this issue.

      If you have any further questions or comments, please let us know.

      Arnel C.

    • Hello Matthew,

      Your application would need to be able to use a remote MYSQL connection with port 3306. Please use the directions above for creating the connection. If you are the creator of the application, then you would need to construct the connection in your application. If you’re not the developer, then you need to speak with the developer of your application for details on how you can get the application to connect to MySQL. We do not provide coding support for you as it is beyond the scope of support.

      If you have any further questions or comments, please let us know.

      Arnel C.

  • i cant connet to mysql database even after adding my machine ip address on the list of allowed ips in cpanel

    please assiste

    • Hello ceasar,

      It should work fine assuming all credentials are correct. What is the specific error message you are getting?

      Kindest Regards,
      Scott M

    • Hello Amy,

      It seems that it is not possible to load a DB2 database into workbench as IBM has made the software proprietary.

      Best Regards,
      TJ Edens

  • HI ALL,


    I want send an automatic email  in mysql as backend using scheduler….

    can let me know how to send an email ..with steps..

    kindly help me out in this…

    Thanks ,


    • Hello Nagnedra,

      Apologies but that is unfortunately beyond the scope of our support. We do not provide coding support. You may want to study this post that describes a person approaching the same issue.

      Arnel C.

  • I dont have a dedicate IP and it is dynamically allocated by ISP so does it mean i have to change IP on cpanel everytime i refresh the router. (mysql remote connecting to workbench)

    • Hello Zam,

      Yes, you will need to enter the current IP every time you want to connect.

      Kindest Regards,
      Scott M

  • Sorry, did not realize I was on a hosting site. Not having heard of Workbench, I thought I was on a site for support for workbench. Excuse my question please, I am not a customer of yours. Will seek support elsewhere.

    • I’m happy to help where I can.

      Regarding how GravityForms stores it’s data, it is a WordPress standard and nearly all plugins store data in the same way keep things organized. GravityForms is by far the best form handling plugin available for WordPress and is highly respected by WordPress developers, including myself.

      If you’re trying to just work with a database, PHPMyAdmin or MySQL Workbench are your best options.

  • Hi …. before I get into learning your interface with MySql I have a simple question. but first here is my background. I used to build online Apps for websites with MSSQL, and mainly ASP/Javascript etc. I retired 7 years ago, and now find myself on a Linux server with access to MySQL. I have a project I want to do that is very simple, but I don’t know PHP nor MySQL. However, there is plenty of sample coding available onlone that i can edit for the simple things I need to do. I used to use the free MS tool for remote access to the MSSQL server I hosted with a provider, in order to create tables, fields, import/export data, edit field data when needed quickly for a client, do certain queries for maintenance or correcting mistakes made (made plenty of those). Having the visual aid with handson for repair and maintenance type queries was great. Of course most of my work was done from ASP based code. And so my question is, should I expect that Workbench will basically give me the same type of tools that I am used to. I am using WordPress and I already bought Gravity Forms, that was a mistake, they integrate the form data somehow into the WordPress table. I can only find one plugin that creates separate tables, but it is very limited and not well supported. So it looks like my dreaeded concern has raised its head, I have to work from scratch. I desparately need a tool like the one I am used to, because my memory is failing and learning lotsa new coding is only a limited option. At least the project is simple. Finding that your tool might be the trick for me, is great. What can I expect to be able to do out of the things I listed above. They are the only tools I need for a remote connection, create tables, create fields, export/import data, backup, edit fields/rows when I made an error or need a change, and move data from one field to another through query. 

  • can any one help me on this:

    I have installed mysql, i clicked on new connection and entered username and password

    it says Connection parameters are correct SSL not enabled.

    how can i enable SSL.

  • Hello Scott M,

    Thanks for your reply.

    SSL connection is very important???Can I let it go and then still continue to use the software?
    I would like to create a database to connect the php file, then doing the mail merge function to send a mass email to many recipients.

    I am a new user. It is my school project. Could you mind to help me?





    • Hello Sally Mak,

      If you are still needing to connect to the database via SSL then you will need to log into the cPanel and use PHPMyAdmin. You can still use the software without the SSL option as the information is still secure.

      Kindest Regards,
      TJ Edens.

  • There is actually no requirement for the site certificate.  The SSH tunnel is established separately from SSL/TLS.  Although SSH may utilize SSL/TLS, in the case of MySQL Workbench, only the SSH connection information is required.