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

Solution

This error occurs when the credentials you provide don't match what the server expects — either the wrong value or the wrong format for your account type.

Go to the instance details page and click Account Management in the left navigation pane to check your account type. If you have forgotten a password, click Reset Password in the Actions column for that account.

Use the connection format that matches your account type:

• Default account: Pass only the password.

  redis-cli -h <host> -p <port> -a <password>

• Standard account: Pass the credentials as <account>:<password>. For example, for account testaccount with password Rp829dlwa, the credential string is testaccount:Rp829dlwa.

  Sample command:

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

Other connection scenarios

• Third-party tools such as RDM:

  Enter the full <account>:<password> string directly into the password field.

• Password-free access with incorrect credentials:

  When password-free access is enabled on a Redis 6.0 instance, the server still validates any credentials you explicitly provide. Providing incorrect credentials triggers the WRONGPASS error. It allows unauthenticated connections but rejects invalid ones. Either provide correct credentials or omit them entirely.

• URI connections with special characters:

  When connecting with a URI such as redis-cli -u redis://<account>:<password>@<host>:<port>/<db>, URL-encode any special characters in your password. Common encodings:

  # 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>

  Character	Encoded form
  @	%40
  #	%23
  !	%21
  $	%24
  %	%25
  &	%26
  /	%2F
  :	%3A