#107466[redis] Session handler is not configured properly: Unknown named parameter $sessionPath
Description
When using the redis configuration as described in
// config/system/settings.php
return [
'BE' => [
'installToolSessionHandler' => [
'className' => \TYPO3\CMS\Install\Service\Session\RedisSessionHandler::class,
'options' => [
'host' => '127.0.0.1',
'port' => 6379,
'database' => 0,
'authentication' => [
'user' => 'redis',
'pass' => 'redis'
]
]
]
]
];
via system/settings.php (important on this file is affected, additional.php works),
the default configuration and this redis configuration are merged which means that redis and file session handler options are defined:
installToolSessionHandler
className = TYPO3\CMS\Install\Service\Session\RedisSessionHandler
options
authentication
pass = redis
user = redis
database = 0
host = 127.0.0.1
port = 6379
sessionPath = /var/www/…/session
You see that $sessionPath is added because it is configured in DefaultConfiguration.php which ultimately resolves in a constructor error which is (thankfully!) logged as:
Wed, 17 Sep 2025 08:51:33 +0200 [ERROR] request="bb869bc0ecc7a" component="TYPO3.CMS.Install.Service.SessionService": Session handler is not configured properly: Unknown named parameter $sessionPath
Also see https://review.typo3.org/c/Packages/TYPO3.CMS/+/89992/comment/8b2e9e6b_9de75fd0/