MySQL Workbench is a free tool that can connect your database to your shared, VPS, or Dedicated hosting account. The application can replace phpMyAdmin as your interface to work with your database.
We will provide you with the information to download and install the application. Then, we will guide you through the steps to set up a remote connection to your database.
- Download and Install MySQL Workbench
- Video – How to Connect to a Database with MySQL Workbench
- Add IP Address to Remote MySQL
- Connect to Your Database Remotely
Download and Install MySQL Workbench
Use MySQL Workbench as a visual tool for many tasks, including SQL development, data modeling, and database administration. The tool is available for Windows, Linux, and Apple operating systems.
Download MySQL Workbench for free from the MySQL home page.
Once you have downloaded the version of MySQL Workbench to match your computer, install it based on your operating system requirements.
Video – How to Connect a Database with MySQL Workbench
Add IP to Your Remote MySQL
To connect to your databases remotely, 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 is my IP address?
Connect To Your Database Remotely
After installing MySQL Workbench and saving your IP address in Remote MySQL, you must configure MySQL Workbench to connect to the database. You will also need to know your database credentials. If you have problems obtaining your credentials, please contact our live technical support team for assistance.
- Open MySQL Workbench.
- In the bottom left of the page, click on New Connection.
- Enter your database connection credentials in the Set up a New Connection dialog box. The following is a list of the credentials you will be configuring:
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.
Username: Your cPanel username or the user you created for the database.
Password: cPanel password or the password for the created database user.
Default Schema: This can be left blank.
- Click Test Connection.
- If you see the message “Connection parameters are correct,” click Ok.
- Click Ok again to accept the connection settings.
- You will find your newly created connection in the SQL Development section. Go to Open Connection to Start Querying, then select your connection.
You will see the databases listed on the left side like this:
Once connected to your database, you can use the MySQL Workbench as your new tool to modify, develop, and administrate your databases. Its features make it a great tool you can use without logging into cPanel.
Thoughts on “How to Connect to a Database with MySQL Workbench”
thanks. I am trying to connect to mysql database remotely from home. When I try to follow the steps above It says “your connection attempt failed for user ‘xxxx’ from your host to server at yyyyyyy: cannot connect to MySQL server on ‘yyyyyyy'(10060)”
Thank you for your reply. Based on the information provided, it seems likely that the IP address used to connect is incorrect. Please ensure that the IP/hostname is correct and try again. If the issue persists I recommend contacting Technical Support for direct assistance.
Thanks Alyssa, yes there was wrong as you said. Now works fine .
Very helpful – thank you
Glad it helped!
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.
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?
Yes these instructions can be used to connect your computer to the server via the MySQL service. If you are trying to connect a PC to PC on the same network, you will need to use the local IP address (found on your internal network) as the hostname.
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).
Unfortunately, MySQL Workbench is not compatible with server versions 4, see more here.
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.
As mentioned above: Hostname: You can use your domain our your cPanel IP address.
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’m sorry to see that is happening. You may only update the SQL version on your InMotion Hosting server, if you are subscribed to a VPS or Dedicated Server Hosting plan.
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.
how can i get the url of my database to link my app with it?
The URL can be any domain name that is pointed to the server that hosts your database.
Nice post! This is really helpful. Its nice information for WordPress users. This is really helpful to used my business site developement.
You are very welcome! We’re glad it was helpful for you.
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.
Thanks! After looking on many sites, this was the only one that worked!
Thanks for using our tutorial! If you have any further questions or comments, please let us know.
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?
Sounds like your database user doesn’t have the right permissions. Make sure the user can write to the 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 ??
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.
I was looking for the database server hostname, excecuting this from the myPhpAdmin solved the problem:
Hamzeh, thank you very much for sharing your solution!
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?
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.
I want an application on my local PC to connect to MYSQL on my cpanel
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.
i cant connet to mysql database even after adding my machine ip address on the list of allowed ips in cpanel
It should work fine assuming all credentials are correct. What is the specific error message you are getting?
Is there any way to add a DB2 database in Mysql Workbench?
It seems that it is not possible to load a DB2 database into workbench as IBM has made the software proprietary.
My SQL databases connect smaller versions 5.1 workbench and I send compatibility issues with version 6.3
What version of MySQL are you trying to connect to? We recommend not using any version below 5.0. Are you getting an error when you try to connect?
Thanks for the post
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…
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.
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)
Yes, you will need to enter the current IP every time you want to connect.
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.
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.
Thank you for your question. If you have a a VPS, or Dedicated server, you can Enable SSL/TLS Manager in WHM, for cPanel users.
I could not locate an account on our servers, but if you contact your host they should be able to enable this option for you.
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.
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.
Hello. I tried it but there are some problems.
“Connection parameters are correct
SSL not enabled”
How to enable the SSL?
Why it cannot enable the SSL?
>< Could you comment the problems?
Port 3306 is the port used to connect to MySQL, but there is not an SSL connection involved.
If your site has a certificate installed, you can use SSH to secure you connection to MySQL for MySQL Workbench. In MySQL Workbench, setup the connection as follows:
Click Test Connection and you will be prompted for the <DBUserAccount> password which you can store in your keychain.
Very Nice. It really helped. Very good Mysql Tutorial. Thanks.
yes sir i checked 5 to 10 times but it gives error
Could you please provide the specific error message you are getting?
i have some problem in 5th step my workbeanch is not connect properly it gives some error
What is the error message you are receiving on step 5? Be sure that your connection parameters are correct for the server you are trying to connect to.
i install workbench 6.1 and tried to connect it showing following error
Failed to connect to mysql at ridgesushi.com:3306 with user ******
can’t connect to MYSQL on ‘ridgesushi.com'(10060)
but when i tried to connect with localhost it’s working well
may i know what is the issue ??
Have you already added your IP to the allowed MySQL remote hosts? If not, follow our guide on adding your IP to the MySQL remote hosts.
Thank for replying Arn,
I’ve currently installed mysql workbench 5.2ce.. Also I check that have an update available for 6.0. So my question is it ok to update newer version? Do I get lost my current database and tables?
Your information should still be saved if you update MySQL Workbench.
I’m not seen those import export buttons….
I’m not sure what you have loaded, but here is a link for MySQL Workbench version 6.0. The link will also lead to the documentation on this tool. You can also do it via shell (Plugins > Start Shell for MySQL Utilities):
$ mysqldbimport –server=user:[email protected]:port:socket db1.csv db2.sql db3.gri
You can type –help after each command for a listing of the flags.
$ mysqldbexport –server=user:[email protected]:port:socket db1, db2, db3
(note: this requires either a VPS/Dedicated server account and the appropriate access level).
Thanks for the question. Actually, the .SQL file is a text file. If you’re going to be importing data, it would need to be formatted in some type of table format such as what’s found in .csv files in order to be of some use. You can typically use a SQL client such as phpMyAdmin to import the file. If, as per the posts above, you’re trying to programmatically update the database, you would need to open the table and match the data you’re importing per the database constraints. I hope that helps to answer your question. Please let us know if you need any further information. If you’re interested, check out our article on Importing a Database using phpMyAdmin.
Is there anyway I can import data to mysql workbench database?
Yes you can import data using MySQL Workbench, but you don’t have separate MySQL Workbench databases. It is simply a tool that you use to manage MySQL databases, much like you could use phpMyAdmin on the server itself.
Once you’ve created a connection to a database on the main Home screen in MySQL Workbench, and then connected to that database, you should see the Navigator panel on the left-hand side.
There should be a Data Import/Restore button a bit further down that you can click on. Then on the next page, you’d more than likely want to select Import from Self-Contained File and then select the location of the .sql backup that you’d like to import into the currently selected database.
Thanks for your reply.
I’m not that good to do it… any way is there any screen shot to show me to set up job?
Or do you have any pdf to take me start working on it..
Again, are you sure that what you are trying to setup requires a MySQL job? And what are you referring to when you are talking about a job, or job schedule?
If you’re talking about using the MySQL Event Scheduler, then I’d recommend reading that documentation from MySQL to help understand the concepts of MySQL events, and see if that is indeed something you need to use.
I don’t see a way to directly add MySQL events from MySQL Workbench, so you would just need to use the standard method of doing a normal query for these based on the Event syntax. But again this is only going to be available on a server in which that is turned on server-wide.
Jacob, Thanks for replying me back,
I’m planning to set up job in mysql workbench. This job is for the one of the function is referencing the three tables to populate the data in mysql workbench database. That data is comming from SQL database. So do I also need to set up alert too to get the data from sql server?
Please let me know how to do it?
Hello Dushyant, no problem at all.
Are you sure that what you’re trying to accomplish is best served by a remote MySQL interface? It sounds like you might be trying to programmatically alter the data in your database, and this is typically done with a scripting language such as PHP interacting with the MySQL database.
Typically you’d have your PHP script connect to your database you need to pull data from, then connect to the database you’d like to put that information into and do an INSERT query.
Doing it this way, you could then just setup a normal cron job on the server to run your PHP script to keep updating your databases.
Alternatively this probably could be done with MySQL Workbench, but you would need to turn on the MySQL Event Scheduler to automate things and I’m not sure of the exact process for using jobs in this fashion with a remote MySQL interface.
Is there any way I can set up job schedule in Mysql workbench 5.2ce?
It depends what you mean by being able to set up a job schedule. For instance you can use MySQL Workbench in order to schedule a backup of your database.
Or are you instead referring to the MySQL Event Scheduler? If that is the case, then yes you can create your Events from within MySQL Workbench using the standard syntax for doing so:
Although for this to work, your server’s /etc/my.cnf configuration file must contain the line turning on the Event Scheduler:
Please let us know if you had any further questions at all.