Redis Software automatically logs users out of the Cluster Manager UI after a period of inactivity—by default, 15 minutes. You can configure this Auto UI Logout Timeout (session timeout) to better align with your environment's security or usability needs. This guide explains how to adjust the timeout using the Cluster Manager UI, rladmin CLI, or the REST API, and includes a Troubleshooting section and a summary of available commands. Timeout customization via UI is available in versions 6.2.12 and later, with version-specific path variations noted for 7.2 and earlier.
Prerequisites
Admin access required
- You must have administrative privileges on the Redis cluster to make changes.
Version requirements
- Full session timeout customization in the UI is supported in Redis Software 7.4+.
- UI paths for versions prior to 7.2 differ slightly (noted below).
Step-by-Step Instructions
Change Timeout via Cluster Manager UI
-
Redis Software 7.4+:
- Go to:
Cluster > Security > Preferences - Click Edit, locate the Session timeout field
- Choose the unit (minutes or hours) and enter your desired value
- Click Save
- Go to:
-
Redis Software <7.2:
- Go to:
Settings > Preferences > Session timeout
- Go to:
Change Timeout via CLI (rladmin)
To set the session timeout from any node:
rladmin cluster config cm_session_timeout_minutes <number_of_minutes>To verify the current session timeout:
rladmin info cluster | grep cm_session_timeout_minutesChange Timeout via REST API
Send a PUT request to the /v1/cluster endpoint:
curl -u <admin-email>:<password> \
-X PUT \
-H "Content-Type: application/json" \
-k \
-d '{"cm_session_timeout_minutes": <number_of_minutes>}' \
https://<your-cluster-host>:9443/v1/cluster
- Replace
<admin-email>,<password>, and<your-cluster-host>as appropriate - A successful response confirms the setting has been applied
Troubleshooting
| Issue | Likely Cause | Recommended Action |
|---|---|---|
| Users logged out before configured timeout | Browser cache or session handling | Clear cookies/cache, use incognito mode, or try a different browser |
| Timeout setting doesn’t take effect | Unsaved changes or missing admin privileges | Save changes and verify user role has admin permissions |
| Timeout value not updated | Verification step missed | Run rladmin info cluster to confirm setting |
| Logout persists despite updates | External browser/system interference | Collect logs, check browser sleep/power/network settings, and contact Redis Support |
Summary: Timeout Configuration Commands
| Method | Command or Path |
|---|---|
| UI |
Cluster > Security > Preferences > Session Timeout (7.4+)Settings > Preferences (pre-7.2) |
| CLI | rladmin cluster config cm_session_timeout_minutes <X> |
| REST API | PUT /v1/cluster { "cm_session_timeout_minutes": <X> } |
0 comments
Please sign in to leave a comment.