[TFE] Redis Issue: "ERR wrong number of arguments for 'hset' command"

Avatar
Connor Fryar
  • Updated

Summary

Terraform Enterprise (TFE) may fail to start when configured with unsupported or older versions of external Redis. This issue arises in environments using Redis versions below v6.

Prerequisites

  • TFE version: >= v202301-1
    • Rationale: Redis v6 and v7 are supported starting in this release.
  • External Redis (e.g., Active-Active mode).

Tested Configuration

  • TFE FDO on OpenShift
  • TFE Version: v202411-1
  • Redis: Redis Enterprise

Troubleshooting

  1. Check TFE logs for the following warning:
WARN: Redis::CommandError: ERR wrong number of arguments for 'hset' command


Solution

  • Verify that your Redis version is v6 or later.
  • Ensure that the version aligns with your current TFE release requirements.
  • If using Redis OSS, consider upgrading or switching to Redis Enterprise for compatibility. See Redis Enterprise configuration settings on TFE.

Articles in this section

See more