MySQL Workbench: How to Connect to MySQL

MySQL Workbench is one of the most widely used visual administration tools for managing databases. To connect to your instance on Square Cloud, you will need to configure the network parameters and, mandatorily, the SSL certificate to ensure an encrypted connection.

1. Locating Access Information

Before starting, have the data extracted from your connection URL in the Square Cloud dashboard ready:

• Hostname: square-cloud-db-{id}.squareweb.app
• Port: The number that appears after the host (e.g., 3306).
• Username: squarecloud
• Password: The password defined during instance creation.

2. Creating a New Connection

1. Open MySQL Workbench and click the "+" icon next to "MySQL Connections".
2. In the Connection Name field, give it a name of your preference (e.g., "Square Production DB").
3. In the Parameters tab, fill in:

• • Hostname: Paste your host address.
  • Port: Enter your database port.
  • Username: Type squarecloud.

3. Configuring the SSL Certificate

For security reasons, Square Cloud requires the connection to be made via SSL. Without this step, the connection will be refused by the server.

1. Still in the configuration window, click the SSL tab.
2. In the Use SSL field, select the Require or If available option.
3. In the SSL CA File field, click the selection button (three dots) and point to the .crt file you downloaded from the Square Cloud dashboard.

Attention: Make sure to use the file with the .crt extension. It is responsible for validating the server's Certificate Authority (CA).

4. Testing the Connection

1. Click the Test Connection button in the bottom right corner.
2. Workbench will prompt you for your Password. Enter your instance password.
3. If everything is correct, you will see a message confirming that the SSL connection was successfully established.

5. Troubleshooting

• SSL Connection Error: Verify that the path to the .crt file is correct and that the file has not been moved to another folder.
• Authentication Plugin: If you encounter authentication plugin errors, make sure you are using an updated version of MySQL Workbench.

Updated on: 05/21/2026