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

# Redis Configuration

> Configuration for the Redis image used for caching and session storage.

### `redis.image.*`

Redis container image configuration. Redis is used by the CrewAI Platform for caching, session management, and real-time features.

<ParamField path="redis.image.host" type="string" default="">
  Container registry hosting the Redis image.

  **Default:** `""` (empty) - Automatically uses `global.imageRegistry` value

  **Fallback Behavior:**

  When `redis.image.host` is empty or not set, the chart uses `global.imageRegistry` via the `crewai-platform.redisImageRegistry` template helper.

  **Automatic Image Override:**

  The chart automatically sets the `REDIS_IMAGE_OVERRIDE` environment variable by combining these values:

  ```
  REDIS_IMAGE_OVERRIDE = <registry>/<name>:<tag>
  ```

  Where `<registry>` is determined by: `redis.image.host` OR `global.imageRegistry` (fallback)

  **When imageNamePrefixOverride is Set:**

  The image name is automatically simplified:

  * Original: `proxy/crewai/dockerhub/library/redis`
  * With `imageNamePrefixOverride: "crewai/"` becomes: `crewai/redis`

  See [global.imageNamePrefixOverride](/reference/chart-values/global#param-global-image-name-prefix-override) for details.
</ParamField>

<ParamField path="redis.image.name" type="string" default="proxy/crewai/dockerhub/library/redis">
  Redis container image name.

  **Default:** `"proxy/crewai/dockerhub/library/redis"` - Matches Replicated proxy path structure

  **Path Transformation:**

  When `global.imageNamePrefixOverride` is set, only the final component (`redis`) is used with the override prefix.
</ParamField>

<ParamField path="redis.image.tag" type="string" default="latest">
  Redis image version tag.

  **Default:** `"latest"`

  **Note:** Uses the latest stable Redis release to ensure access to recent features, bug fixes, and security updates.
</ParamField>

## Usage

Redis is used for:

* Session storage and management
* Caching frequently accessed data
* Real-time features and WebSocket support
* Background job queue management
* Temporary data storage

**Note:** The Redis image configuration controls which image the application uses when deploying Redis instances. The actual Redis deployment and service configuration are managed by the application runtime.

## Example Configuration

**Default Configuration (using Replicated proxy):**

```yaml theme={null}
redis:
  image:
    host: "" # Uses global.imageRegistry
    name: "proxy/crewai/dockerhub/library/redis"
    tag: "latest"
```

Results in: `images.crewai.com/proxy/crewai/dockerhub/library/redis:latest`

**Private Registry with imageNamePrefixOverride:**

```yaml theme={null}
global:
  imageRegistry: "123456789012.dkr.ecr.us-west-2.amazonaws.com"
  imageNamePrefixOverride: "crewai/"

redis:
  image:
    host: "" # Uses global.imageRegistry
    name: "proxy/crewai/dockerhub/library/redis"
    tag: "latest"
```

Results in: `123456789012.dkr.ecr.us-west-2.amazonaws.com/crewai/redis:latest`

**Custom Registry:**

```yaml theme={null}
redis:
  image:
    host: "harbor.company.com"
    name: "bitnami/redis"
    tag: "7.2.4-debian-12-r0"
```

Results in: `harbor.company.com/bitnami/redis:7.2.4-debian-12-r0`

**Version Pinning:**

```yaml theme={null}
redis:
  image:
    host: ""
    name: "proxy/crewai/dockerhub/library/redis"
    tag: "7.2.4-alpine" # Pin to specific version
```

Results in: `images.crewai.com/proxy/crewai/dockerhub/library/redis:7.2.4-alpine`

## Automatic Configuration

The Redis image configuration automatically:

* Uses `global.imageRegistry` when `redis.image.host` is not set
* Applies `global.imageNamePrefixOverride` for simplified image paths
* Sets the `REDIS_IMAGE_OVERRIDE` environment variable for application use