---
title: "Deprecation: #107725 - Deprecate usage of array in password for authentication in Redis cache backend"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:deprecation-107725-1760807740"
source: "Changelog/14.0/Deprecation-107725-RedisCacheBackendAuthenticationWithUsernameAndPassword.rst"
typo3-version: "14.0"
typo3-major: 14
type: "deprecation"
issue: 107725
forge: "https://forge.typo3.org/issues/107725"
tags: ["LocalConfiguration", "NotScanned", "ext:core"]
rendered: "2026-09-20T18:31:11+00:00"
---

# Deprecation: #107725 - Deprecate usage of array in password for authentication in Redis cache backend {#deprecation-107725-1760807740}

See [forge#107725](https://forge.typo3.org/issues/107725)

## Description {#description}

Since Redis 6.0, it is possible to authenticate against Redis using both a
username and a password. Prior to this version, authentication was only
possible with a password.

With this change, TYPO3's Redis cache backend supports username and password
authentication directly. You can now configure the TYPO3 Redis cache backend
as follows:

**config/system/additional.php**

```php
use TYPO3\CMS\Core\Cache\Backend\RedisBackend;

$GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheConfigurations']['pages']['backend']
    = RedisBackend::class;

$GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheConfigurations']['pages']['options']
    = [
        'defaultLifetime' => 86400,
        'database' => 0,
        'hostname' => 'redis',
        'port' => 6379,
        'username' => 'redis',
        'password' => 'redis',
    ];
```

## Impact {#impact}

The `password` configuration option of the Redis cache backend is now
typed as `array|string`.

Setting this configuration option with an array is deprecated and will be
removed in TYPO3 v15.0.

## Affected installations {#affected-installations}

All installations using the Redis cache backend and configuring the
`password` option as an array containing both username and password
values are affected.

## Migration {#migration}

Use the dedicated configuration options `username` and `password`
instead of passing an array to `password`.

**Before (deprecated):**

**config/system/additional.php**

```php
use TYPO3\CMS\Core\Cache\Backend\RedisBackend;

$GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheConfigurations']['pages']['backend']
    = RedisBackend::class;

$GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheConfigurations']['pages']['options']
    = [
        'defaultLifetime' => 86400,
        'database' => 0,
        'hostname' => 'redis',
        'port' => 6379,
        'password' => [
            'user' => 'redis',
            'pass' => 'redis',
        ],
    ];
```

**After (recommended):**

**config/system/additional.php**

```php
use TYPO3\CMS\Core\Cache\Backend\RedisBackend;

$GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheConfigurations']['pages']['backend']
    = RedisBackend::class;

$GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheConfigurations']['pages']['options']
    = [
        'defaultLifetime' => 86400,
        'database' => 0,
        'hostname' => 'redis',
        'port' => 6379,
        'username' => 'redis',
        'password' => 'redis',
    ];
```