All Products
Search
Document Center

Tair (Redis® OSS-Compatible):What do I do if the "WRONGPASS invalid username-password pair" error occurs when connecting to a Redis Open-Source Edition instance

Last Updated:Dec 26, 2025

The WRONGPASS invalid username-password pair error indicates an incorrect username, password, or credential format when connecting to a Redis Open-Source Edition 6.0 or 5.0 (minor version 5.0.8 and later) instance.

Solution

On the instance details page, click Account Management in the navigation pane on the left to view your account type. You can also click Reset Password in the Actions column corresponding to an account if you forget its password.

Use the correct account and password format to connect to the instance based on your account type:

  • Default account: Specify only the password.

    redis-cli -h <host> -p <port> -a <password>
  • Standard account: Use the following format for connection: <account>:<password>. For example, if your account is testaccount and your password is Rp829dlwa, the password string must be testaccount:Rp829dlwa.

    Sample command:

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

Other connection scenarios

  • Connecting with third-party tools:

    When using a third-party tool, such as RDM, enter the full <account>:<password> string directly into the password field.

  • Incorrect credentials with password-free access:

    If password-free access is enabled on a Redis 6.0 instance, the server still validates any credentials you provide. Providing incorrect credentials triggers the WRONGPASS error. To connect successfully, either provide the correct credentials or omit them entirely.

  • URL encoding for URI connections:

    To connect using a URI, such as redis-cli -u redis://<account>:<password>@<host>:<port>/<db>, URL-encode any special characters in your password.

    # Example for account 'testaccount' with password 'my@password'
    # The '@' character must be encoded as %40
    redis-cli -u redis://testaccount:my%40password@<host>:<port>/<db>