Configure MySQL Workbench

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and MacOS) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). On OS X VMs, the installation directory is /opt/bitnami and OS X VM users can click the “Open Terminal” button to run commands. Learn more about the Bitnami stack environment and about OS X VMs.

NOTE: This section assumes that you have downloaded and installed MySQL Workbench.

To connect to your remote MySQL database server using MySQL Workbench, you have to allow remote connections to the server.

Once your MySQL server is configured to accept remote connections, you can connect to it using MySQL Workbench. Follow these steps:

  • Launch MySQL Workbench.
  • Click the “+” symbol in the “MySQL Connections” tab to add a new connection.

    MySQL Workbench configuration

  • Configure the connection as follows:

    • Enter a name for the connection in the “Connection Name” field.
    • Select “Standard (TCP/IP)” as the “Connection Type”.
    • Enter your server’s IP address in the “Hostname” field.
    • Specify the “Port” as “3306”.
    • Specify the “Username” as “root”.

      MySQL Workbench configuration

  • Click “Test Connection” to test the connection.

  • If the connection is successful, click “OK” to save the connection.

    MySQL Workbench configuration

  • Double-click the new connection to launch the MySQL Workbench SQL Editor. You may be prompted for a password. Use the same password you used when previously configuring the server to accept remote connections. Once connected, the SQL editor window will open and you can interact with the server using SQL commands, as shown below:

    MySQL Workbench configuration

Last modification September 7, 2018