Connecting MySQL
DBDash connects seamlessly to MySQL to provide real-time database management via the Web UI. This page will guide you through the process of establishing a connection to your MySQL server.
đź“‹ Preparing MySQL
Before connecting DBDash to MySQL, make sure the following prerequisites are in place:
- MySQL is installed and running on your local machine or a remote server.
- Ensure your MySQL user has sufficient privileges to access the database (e.g., SELECT, INSERT, UPDATE, DELETE).
- Confirm that the MySQL server’s port (default:
3306
) is open and accessible.
You can verify the MySQL server is running by connecting to it via the command line:
mysql -u root -p
âś… If you can connect without issues, you're ready to proceed.
đź”— Configure MySQL Connection
Now, let’s configure the connection in DBDash. To do this, follow these steps:
- Open the DBDash Web UI in your browser at
http://localhost:3000
. - On the login screen, click on the "Add New Connection" button.
- In the connection settings form, fill in the following fields:
- Host: The IP address or hostname of your MySQL server (e.g.,
localhost
for local setup or the IP address of a remote server). - Port: Default is
3306
. If you are using a custom port, enter that. - User: The MySQL username you want to use (e.g.,
root
or another user). - Password: The corresponding password for the MySQL user.
- Database (optional): You can specify a database here or leave it blank to connect to the MySQL server and view all databases.
- Host: The IP address or hostname of your MySQL server (e.g.,
- Click "Save" to store the connection settings.
After saving, you will be able to see your connection listed on the dashboard.
⚠️ Troubleshooting Connection Issues
If you're having trouble connecting to MySQL, check the following:
- If you see a "Connection Refused" error, make sure MySQL is running and listening on the correct port.
- If you’re connecting remotely, ensure that your firewall or cloud security settings allow inbound connections on port
3306
. - Check that the MySQL user you're using has the necessary permissions and that the username/password is correct.
If the issue persists, check the MySQL logs or refer to the Troubleshooting guide for more detailed solutions.