From 749ae4663ceefc29cf582d731954d8a1da3c4c7c Mon Sep 17 00:00:00 2001
From: "claude[bot]" <209825114+claude[bot]@users.noreply.github.com>
Date: Wed, 29 Oct 2025 23:02:26 +0000
Subject: [PATCH 1/2] docs: add required Redis mode parameter to v2
 authentication docs

- Add mode parameter to Redis session storage examples in authentication.mdx
- Include mode parameter in Redis properties table in overview.mdx
- Document that mode must be either 'single' or 'cluster'
- Add cluster configuration example
- Fixes missing documentation for Redis mode configuration

Co-authored-by: Mark Phelps <markphelps@users.noreply.github.com>
---
 docs/v2/configuration/authentication.mdx | 23 +++++++++++++++++++++++
 docs/v2/configuration/overview.mdx       |  1 +
 2 files changed, 24 insertions(+)

diff --git a/docs/v2/configuration/authentication.mdx b/docs/v2/configuration/authentication.mdx
index 664bcdb..620c9e4 100644
--- a/docs/v2/configuration/authentication.mdx
+++ b/docs/v2/configuration/authentication.mdx
@@ -116,6 +116,29 @@ authentication:
     storage:
       type: redis
       redis:
+        mode: single  # Required: either "single" or "cluster"
+        host: localhost
+        port: 6379
+        db: 0
+        password: password
+```
+
+The `mode` parameter is **required** and must be set to either:
+- `single` - For standalone Redis instances (most common)
+- `cluster` - For Redis cluster setups
+
+##### Redis Cluster Example
+
+For Redis cluster configurations, use `mode: cluster`:
+
+```yaml config.yaml
+authentication:
+  required: true
+  session:
+    storage:
+      type: redis
+      redis:
+        mode: cluster
         host: localhost
         port: 6379
         db: 0
diff --git a/docs/v2/configuration/overview.mdx b/docs/v2/configuration/overview.mdx
index 2eefd82..731e451 100644
--- a/docs/v2/configuration/overview.mdx
+++ b/docs/v2/configuration/overview.mdx
@@ -314,6 +314,7 @@ Authentication configuration controls how users and systems authenticate with Fl
 
 | Property                                                | Description                                                         | Default   | Since  |
 | ------------------------------------------------------- | ------------------------------------------------------------------- | --------- | ------ |
+| authentication.session.storage.redis.mode               | **Required** Redis mode: `single` or `cluster`                      | single    | v2.0.0 |
 | authentication.session.storage.redis.host               | Host to access the Redis database                                   | localhost | v2.0.0 |
 | authentication.session.storage.redis.port               | Port to access the Redis database                                   | 6379      | v2.0.0 |
 | authentication.session.storage.redis.db                 | Redis database to use                                               | 0         | v2.0.0 |

From 4a2fa6212a58588c427c81e7beff389b328e90fa Mon Sep 17 00:00:00 2001
From: Mark Phelps <209477+markphelps@users.noreply.github.com>
Date: Fri, 31 Oct 2025 14:47:19 -0400
Subject: [PATCH 2/2] chore: format

Signed-off-by: Mark Phelps <209477+markphelps@users.noreply.github.com>
---
 docs/v2/configuration/authentication.mdx | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/v2/configuration/authentication.mdx b/docs/v2/configuration/authentication.mdx
index 620c9e4..6700dd2 100644
--- a/docs/v2/configuration/authentication.mdx
+++ b/docs/v2/configuration/authentication.mdx
@@ -116,7 +116,7 @@ authentication:
     storage:
       type: redis
       redis:
-        mode: single  # Required: either "single" or "cluster"
+        mode: single # Required: either "single" or "cluster"
         host: localhost
         port: 6379
         db: 0
@@ -124,6 +124,7 @@ authentication:
 ```
 
 The `mode` parameter is **required** and must be set to either:
+
 - `single` - For standalone Redis instances (most common)
 - `cluster` - For Redis cluster setups