Connect your MySQL database to Basedash to visualize and analyze your application data.

Prerequisites

  • A MySQL database (version 5.7 or higher)
  • Database credentials with read access
  • Database host and port information
  • If using SSH tunnel: SSH credentials and host information

Connection methods

Direct connection

  1. From your Basedash dashboard, click “Add Data Source”
  2. Select “MySQL” as your database type
  3. Enter your connection details:
    • Host (e.g., localhost or your-db.host.com)
    • Port (default: 3306)
    • Database name
    • Username
    • Password
  4. Click “Test Connection” to verify
  5. Save your connection

SSH tunnel

For enhanced security when your database is in a private network:

  1. Follow the direct connection steps above
  2. Enable “Connect via SSH” option
  3. Add our IP (24.199.77.73) to your allowlist
  4. Provide SSH connection details:
    • SSH host
    • SSH username
    • Authentication method (password or key)
  5. Test and save the connection

Best practices

  • Use a read-only database user for Basedash
  • Consider using an SSH tunnel for databases in private networks
  • Regularly rotate database credentials
  • Monitor query performance and set appropriate limits

Troubleshooting

  • Ensure your database user has SELECT permissions on required tables
  • Check if your database host allows external connections
  • Verify firewall rules allow connections from Basedash IP
  • For connection issues, check database logs for error messages