> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shiftlabs.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Redis

> Connect Redis instances for caching and data storage

Connect your Redis instances to browse keys, monitor performance, and manage data through ShiftLabs.

## Connection Types

| Type           | Description                          |
| -------------- | ------------------------------------ |
| **Standalone** | Single Redis server                  |
| **Sentinel**   | Redis Sentinel for high availability |
| **Cluster**    | Redis Cluster for horizontal scaling |

## How to Add a Redis Connection

<Steps>
  <Step title="Open Integrations">
    Go to **Settings → Integrations → Redis** tab.
  </Step>

  <Step title="Click Add Redis Connection">
    Click the **Add Redis Connection** button.
  </Step>

  <Step title="Select Connection Type">
    Choose **Standalone**, **Sentinel**, or **Cluster**.
  </Step>

  <Step title="Enter Connection Details">
    **Standalone:**

    * **Host** (required): Redis server address
    * **Port** (required): Redis port (default: 6379)

    **Sentinel:**

    * **Master Name** (required): Name of the master
    * **Sentinel Hosts** (required): List of sentinel host:port pairs

    **Cluster:**

    * **Cluster Nodes** (required): List of cluster node host:port pairs

    **Common options:**

    * **Name** (required): Display name for this connection
    * **Authentication**: None or Password
    * **Password**: Required if authentication is enabled
    * **TLS Enabled**: Enable TLS encryption
  </Step>

  <Step title="Save">
    Click **Create**. Use the health check to verify connectivity.
  </Step>
</Steps>

## How to Edit a Redis Connection

1. Click the edit icon on the connection row
2. Modify the settings
3. Click **Save**

<Tip>
  Leave the password field empty when editing to keep the existing password.
</Tip>

## How to Check Health

Click the **Check** button to verify connectivity. A successful check shows Redis version and memory usage.

## How to Delete a Redis Connection

1. Click the delete icon on the connection row
2. Confirm the deletion

<Warning>
  Deleting removes the connection only. Data in Redis is not affected.
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Health check shows Unhealthy">
    1. Verify host and port are correct
    2. Check if password is required and correct
    3. Ensure network connectivity to Redis
    4. For TLS, verify certificates or check TLS configuration
  </Accordion>

  <Accordion title="Sentinel connection fails">
    1. Verify all sentinel hosts are correct
    2. Check the master name matches Sentinel configuration
    3. Ensure sentinels are running and accessible
  </Accordion>

  <Accordion title="Cluster connection fails">
    1. Verify at least one cluster node is correct
    2. Ensure cluster is properly initialized
    3. Check if CLUSTER commands are enabled
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Can I connect multiple Redis instances?">
    Yes. Add connections for different purposes (cache, sessions, queues).
  </Accordion>

  <Accordion title="Which connection type should I use?">
    * **Standalone**: Simple setups, development
    * **Sentinel**: High availability with automatic failover
    * **Cluster**: Large datasets requiring horizontal scaling
  </Accordion>

  <Accordion title="Is TLS required?">
    No, but recommended for production. Enable TLS for encrypted connections.
  </Accordion>
</AccordionGroup>