How to verify if Redis Cluster or Redis Sentinel is enabled

Introduction

Terraform Enterprise does not support Redis Cluster. However, support for Redis Sentinel was introduced in version v202503-1. For more details, refer to the Redis requirements documentation and the v202503-1 release notes.

This article provides the procedure to verify whether Redis Cluster or Redis Sentinel is enabled in your environment.

Expected Outcome

After completing this guide, you will be able to confirm that your Redis instance does not have Redis Cluster or Redis Sentinel enabled.

Prerequisites

• Access to the Terraform Enterprise host environment.
• docker or kubectl command-line access.
• redis-cli installed or accessible within the container.

Procedure

1. Connect to your Terraform Enterprise container.

   For Docker-based installations:

   $ docker exec -it terraform-enterprise bash

   For Kubernetes-based installations, replace <pod_name> with your pod's name:

   $ kubectl -n terraform-enterprise exec -it <pod_name> -- bash

2. Identify your Redis host and port from the environment variables. Note the value of TFE_REDIS_HOST.

   $ env | grep REDIS
   ## TFE_REDIS_HOST=your-redis-hostname.example.com:6380

3. Connect to your Redis instance using redis-cli.

   $ redis-cli -h your-redis-hostname.example.com -p 6380

4. Check the Redis Cluster status by running the cluster info command. The expected output indicates that cluster support is disabled.

   your-redis-hostname.example.com:6380> cluster info
   ERR This instance has cluster support disabled

5. Check the Redis Sentinel status by running the sentinel masters command. The expected output is an error indicating the command is unknown, which confirms Sentinel is not active on this instance.

   your-redis-hostname.example.com:6380> SENTINEL masters
   (error) ERR unknown command `SENTINEL`, with args beginning with: `masters`,

If your output differs from the examples above, your Redis configuration may not meet the requirements for Terraform Enterprise. Contact your internal infrastructure team to review the Redis deployment.

Additional Information

• For more details on storage requirements, see the Terraform Enterprise Redis requirements documentation.