All Products
Search
Document Center

Tair (Redis® OSS-Compatible):Error when connecting to an instance: WRONGPASS invalid username-password pair

Last Updated:Sep 19, 2025

The WRONGPASS invalid username-password pair error occurs when you use an incorrect password or an invalid password format to connect to a Redis Open-Source Edition 6.0 or 5.0 (minor version 5.0.8 or later) instance.

Solution

Go to the instance details page. In the navigation pane on the left, click Account Management to view the account type. If you forget the password, click Reset Password on this page.

The following are the correct formats for accounts and passwords:

  • Default account: Enter only the password.

    redis-cli -h <host> -p <port> -a <password>
  • Standard account: The password format is <account>:<password>. For example, if the account name is testaccount and the password is Rp829dlwa, enter the password as testaccount:Rp829dlwa.

    Command example:

    redis-cli -h <host> -p <port> -a testaccount:Rp829dlwa

Other scenarios

  • Connecting with a third-party management tool:

    To connect to the instance using a third-party management tool, such as RDM, enter the password in the <account>:<password> format in the password field.

  • Incorrect password with password-free access:

    After you enable password-free access for a Redis Open-Source Edition 6.0 instance, this error is returned if you enter an incorrect account password. To resolve this issue, enter the correct account password or leave the password field empty.

  • Special characters in URI mode:

    If you connect using a URI (for example, redis-cli -u redis://<account>:<password>@<host>:<port>/<db>), you must URL-encode any special characters in the password.

    # Assume the account is testaccount and the password is my@password
    # The at sign (@) is encoded as %40
    redis-cli -u redis://testaccount:my%40password@<host>:<port>/<db>