You are viewing the documentation of an older version of the TiDB database (TiDB v5.4).

It is recommended that you use the latest LTS version of the TiDB database.

Access TiDB Dashboard

To access TiDB Dashboard, visit via your browser. Replace with the actual PD instance address and port.

If multiple PD instances are deployed in your cluster and you can directly access every PD instance and port, you can simply replace in the address with any PD instance address and port.


If a firewall or reverse proxy is configured and you cannot directly access every PD instance, you might not be able to access TiDB Dashboard. Usually, this is because the firewall or reverse proxy is not correctly configured. See Use TiDB Dashboard behind Reverse Proxy and Secure TiDB Dashboard to learn correctly configure the firewall or reverse proxy when multiple PD instances are deployed.

Browser compatibility

You can use TiDB Dashboard in the following common desktop browsers of a relatively newer version:

  • Chrome >= 77
  • Firefox >= 68
  • Edge >= 17

If you use the browsers above of earlier versions or other browsers to access TiDB Dashboard, some functions might not work properly.

Sign in

After accessing TiDB Dashboard, you will be directed to the user login interface, as shown in the image below.

  • You can sign in to TiDB Dashboard using the TiDB root account.
  • If you have created a User-defined SQL User, you can sign in using this account and the corresponding password.

Login interface

If one of the following situations exists, the login might fail:

  • TiDB root user does not exist.
  • PD is not started or cannot be accessed.
  • TiDB is not started or cannot be accessed.
  • Wrong root password.

Once you have signed in, the session remains valid within the next 24 hours. To learn how to sign out, refer to the Logout section.

Switch language

The following languages are supported in TiDB Dashboard:

  • English
  • Chinese (simplified)

In the SQL User Sign In page, you can click the Switch Language drop-down list to switch the interface language.

Switch language


Once you have logged in, click the login user name in the left navigation bar to switch to the user page. Click the Logout button on the user page to log out the current user. After logging out, you need to re-enter your username and password.


Was this page helpful?