Launching the Web UI

After setting up DBDash and your MySQL server, you can easily launch the Web UI to manage your database visually. Follow the steps below to start the Web UI and access it from your browser.

📋 Web UI Prerequisites

  • Ensure that DBDash server is running (refer to the Starting the Server page if needed).
  • A modern browser such as Chrome, Firefox, or Safari.
  • Ensure your firewall settings allow inbound connections on port 3000 (or the port configured for the Web UI).

🚀 Launch the Web UI

Once the server is running, you can access the Web UI by navigating to the following address in your browser:

http://localhost:3000

If you’ve configured a different port for the Web UI, replace 3000 with your custom port number in the URL.

✅ The Web UI will prompt you for connection credentials if you haven't logged in yet.

🔐 Login to Web UI

Once you've accessed the Web UI, you'll need to log in using your credentials to connect to your MySQL database. The login screen will prompt you for the following:

  • Username: Your MySQL username (e.g., root, admin, or a user you’ve configured)
  • Password: The corresponding password for the username
  • Database: Optional (you can leave this blank to view all available databases)

After entering your credentials, click the "Login" button to proceed.

✅ The Web UI will remember your connection details for future use, unless you choose to log out.

📊 Navigating the Web UI

After logging in, you’ll be taken to the main dashboard. Here are some key sections of the Web UI:

  • Schema Explorer: View and manage your database schemas with an intuitive, drag-and-drop interface.
  • Query Editor: Write, execute, and test SQL queries with a built-in editor.
  • Data Viewer: Inspect and edit data in tables, rows, and columns easily.
  • Settings: Configure the Web UI settings, including appearance and connection preferences.

You can start interacting with your database right from the Web UI, whether it's running queries or visualizing your schema.

⚠️ Troubleshooting

  • If you can’t access the Web UI, check if the DBDash server is running properly.
  • If you're seeing a "Connection Refused" error, ensure that the correct port is open and not blocked by your firewall.
  • Make sure you're using the correct MySQL username and password to log in.

If the issue persists, visit the Troubleshooting page for more in-depth solutions.

🚀 Proceed to Usage Guide