Installation
Install cPanel Redis Manager on a supported server with the public one-line deployment command.
Open section
cPanel Redis Manager documentation
Everything you need to install, configure, and manage v2.3.8 on cPanel and WHM.
This documentation covers installation, upgrades, uninstall, configuration, CloudLinux guidance, roadmap details, and release history for cPanel Redis Manager. It is written for server owners, administrators, developers, and hosting teams who need clear deployment and operating guidance for Redis inside cPanel and WHM.
v2.3.8
Install & Upgrade
CloudLinux Ready
Roadmap Included
Release History
Uninstall
Remove the Redis Manager plugin cleanly using the documented uninstall workflow.
Open sectionConfiguration
Review Redis defaults, memory settings, eviction policies, presets, and deployment behavior.
Open sectionCloudLinux
Enable the Redis PHP extension correctly with CloudLinux, Select PHP Version, and CageFS-aware hosting stacks.
Open sectionRoadmap
See the current public release position, next milestone, and the planned direction for Redis Manager.
Open sectionChangelog
Review recent product releases, public rollout updates, and the features already delivered.
Open sectionUpgrade Guide
Follow the upgrade path for in-place updates, legacy reinstall cases, and post-upgrade verification.
Open section
Documentation overview
Everything you need to deploy, manage, and maintain Redis Manager on cPanel and WHM.
Start with installation, review upgrade and uninstall guidance, understand configuration and CloudLinux behavior, and follow the current roadmap and release history from one place.
Deploy Redis Manager on a supported server
Follow the installation flow to validate your license, deploy the cPanel and WHM components, and prepare Redis Manager for production use.
Keep your server on the current release
Use the documented upgrade path for in-place updates, legacy reinstall cases, and post-upgrade verification when moving to the latest public version.
Remove Redis Manager cleanly
Use the approved uninstall workflow to remove the Redis Manager plugin and related components without guessing through server paths or manual cleanup steps.
Use safe defaults and adjust when needed
Review how Redis Manager handles defaults, presets, memory settings, and deployment behavior so you know what to expect after installation.
Enable Redis correctly in customer runtimes
CloudLinux guidance explains how to use Select PHP Version, CageFS refreshes, and the Redis extension so applications can connect properly.
Track the release path and product direction
See the current public rollout, the next planned milestone, and the recent changes already delivered in the live Redis Manager package.
Install cPanel Redis Manager on your server
Important: A valid license is required before installation. Run the installer as root on a supported cPanel and WHM server.
-
Place your order
Order cPanel Redis Manager for your server. Once activated, you will receive your Redis Manager license key and the installation command for deployment.
-
Confirm server requirements
Before installing, make sure the server is running a supported cPanel and WHM environment with root SSH access, a supported operating system, and enough available memory for Redis workloads.
-
Enable the PHP Redis extension
Applications will still need the Redis PHP extension enabled in the PHP versions they use. On EasyApache systems, install the matching ea-phpXX-php-redis packages, our installer will try to install them first. On CloudLinux, enable redis in Select PHP Version.
-
Run the installer as root
Execute the provided installation command over SSH as root. The installer validates the license, deploys the cPanel and WHM plugin files, installs required components, applies migrations, and prepares the Redis Manager runtime automatically.
-
Verify the deployment
After installation, confirm the WHM interface is available for administrators and that Redis Manager appears inside cPanel for supported accounts. This confirms the plugin deployment and registration completed correctly.
-
Create your first Redis instance
Open Redis Manager in cPanel to initialize an instance, review connection details, apply a preset if needed, and begin using Redis with your website or application.
-
Connect your application
Update your application to use the Redis host, port, password, and database details shown in cPanel. Once connected, you can monitor activity, review usage, and manage backups directly from the plugin.
Coming from a release older than v2.0.3?
If your server is still using the first-generation Redis Manager module from before v2.0.3, remove the old cPanel plugin first before installing the current public release.
/usr/local/cpanel/scripts/uninstall_plugin /usr/local/cpanel/base/frontend/jupiter/redis_plugin --theme=jupiter
rm -rf /usr/local/cpanel/base/frontend/jupiter/redis_pluginThis removes the old module interface only. Your existing Redis data, configuration, ports, passwords, and running Redis instances stay intact during this cleanup. Once the legacy module is removed and the current Redis Manager version is installed, the product interface returns and your Redis environments continue normally.
- Only required for legacy releases before v2.0.3
- Safely removes outdated cPanel plugin interface
- No impact on running Redis service
- All Redis instances continue running during cleanup
- No data loss for cached data or stored keys
- Ports, AUTH passwords, and instance configs remain unchanged
- Per-account Redis environments stay intact
- No need to recreate Redis instances after reinstall
- New Redis Manager detects existing instances automatically
- cPanel interface is restored after reinstall
- WHM integration is rebuilt cleanly
- Safe transition from legacy architecture to current system
- No downtime required for Redis-backed applications
- Session storage and object cache continue working
- No manual migration of Redis data required
- Supports immediate reinstall after cleanup
- Compatible with existing CloudLinux environments
- Does not affect MySQL or PHP runtime configuration
- Installer reattaches to existing Redis processes
- Production-safe cleanup path used in real deployments
- Prevents conflicts between old and new plugin versions
- Keeps server-level Redis configuration intact
- Ensures clean UI and control panel rebuild
- Recommended step before any major version upgrade
Remove Redis Manager from your server
Use the approved uninstall command to remove the Redis Manager plugin, services, and related components cleanly.
curl -sSL https://backup.underhost.com/mirror/redis/uninstall.sh | bash -s -- -yClean removal and redeployment
Use this command when you need to fully remove Redis Manager before reinstalling, migrating, or resetting the server environment.
- Removes plugin and WHM integration
- Cleans Redis instances and configuration
- Prepares server for fresh deployment
Configuration
Start with safe defaults, adjust only when your workload requires it.
cPanel Redis Manager is designed for real hosting environments with predictable behavior, clear control panel visibility, and minimal need for manual tuning after deployment.
Redis service behavior
- Redis Manager deploys Redis with production-ready defaults optimized for cPanel hosting environments.
- Designed for common workloads such as object caching, session storage, queues, and repeated data lookups.
- Applications must still use a Redis client or PHP extension to interact with the Redis instance.
cPanel and WHM access
- Users access Redis Manager directly inside cPanel under the Software section.
- WHM provides full administrative control including account management, recovery, limits, and global settings.
- This separation keeps user workflows simple while maintaining full server-level control.
Memory and performance sizing
- Minimum 2GB RAM required, 4GB or more recommended for stable Redis and application performance.
- High-traffic websites, APIs, or multi-account servers should allocate additional memory for Redis usage.
- Memory sizing should reflect cache size, traffic load, and overall server resource usage.
Configuration and presets
- Built-in presets are available for common use cases like WordPress, Laravel, Magento, and generic workloads.
- Settings such as memory limits, eviction policies, and databases can be adjusted safely from the interface.
- Default configurations are designed to work without requiring immediate manual tuning.
Post-install behavior
- Redis Manager becomes available in WHM for admins and in cPanel for users after installation completes.
- Redis instances are isolated per account with their own configuration, port, and authentication.
- No manual setup is required for most deployments, allowing immediate use after installation.
Enable Redis in the application layer
Redis Manager provides the Redis service and control panel workflow, but applications still need the Redis extension or client library enabled in the PHP versions they use.
Adjust only when needed
Most deployments work well with default settings. Review memory usage, application behavior, and traffic patterns before applying targeted configuration changes for heavier workloads.
CloudLinux support
Separate the Redis service layer from the PHP runtime layer.
cPanel Redis Manager provides the Redis service, cPanel workflow, and WHM management tools. CloudLinux still controls how the Redis extension is exposed inside customer PHP environments.
Recommended flow for CloudLinux-based cPanel servers
- cPanel Redis Manager works on supported CloudLinux-based cPanel and WHM servers when the normal installation requirements are met.
- On CloudLinux systems, enable the Redis PHP extension through Select PHP Version for each PHP runtime that needs Redis support.
- Installer will automaticly detect if CageFS is enabled, and will refresh CageFS after changing extension availability so users can see the updated PHP environment.
- Redis Manager provides the Redis service, cPanel workflow, and WHM control layer, but applications still need the Redis extension or client library enabled in their runtime.
- Each application connects using the Redis host, port, password, and database details provided by the Redis instance inside cPanel.
- WHM remains the administrative surface for broader server control, including defaults, package settings, recovery, security, and operational management.
Roadmap
Current release status, upcoming patches, and the full planned roadmap.
This roadmap includes the active public release, the next late v2.3.x adoption patches, the first provider-control milestone in v2.4.0, and the longer-term product direction beyond it.
v2.3.8 Released
The current public release delivers the full cPanel and WHM Redis workflow in one production-ready package, with monitoring, backups, recovery tools, and historical visibility built in.
- cPanel lifecycle controls, monitoring, backups, restore, and safer configuration handling
- WHM dashboard, account management, package controls, branding, recovery tools, and restricted CLI access
- 24-hour and 7-day historical graphs for memory usage, connections, and cache hits versus misses
- installer, uninstaller, upgrade path, and migrations ready for public deployment
v2.3.9 Planned
Redis Health Score and Smart Suggestions adds a readable confidence layer on top of monitoring so users and admins can understand instance quality faster without relying only on raw metrics.
- health score out of 100 for each Redis instance
- health grade display such as Good, Warning, or Critical
- smart suggestions for memory pressure, weak cache efficiency, idle services, and config mismatch
- health score visibility inside both cPanel and WHM
v2.3.10 Planned
Connection Helper Wizard and Setup Preflight reduces first-use friction so customers can connect applications faster and support teams can troubleshoot deployment issues more cleanly.
- ready-to-copy connection helper values
- framework-specific snippets for WordPress, Laravel, Magento, generic PHP, Node, and Python
- setup preflight checks for PHP extension presence, runtime mismatch, missing auth values, and environment readiness
- diagnostics bundle export for support-safe triage
v2.3.11 Planned
Application Detection and Integration Health Check focuses on proving that applications are actually using Redis correctly, not only that the Redis service is online.
- application detection for WordPress, Laravel, Magento, custom PHP, and common CMS footprints
- integration health checks for extension status, app config, auth match, and real Redis traffic
- adaptive presets, snippets, and help text based on detected application type
- known issue flags such as Redis running while the application still uses file cache
v2.4.0 Planned
Hosted Redis Control Foundation is the first true provider-control and monetization milestone, moving Redis Manager from a public sales-ready product into stronger hosted-feature governance.
- package-tier Redis availability enforcement
- reseller quotas and limits
- provider monetization hooks for hosted Redis plans
- provider-side feature exposure modes such as simple, developer, and advanced
How Redis Manager reached the current public release
The live product is built on top of multiple completed phases covering the original public baseline, installer and migration improvements, WHM integration, stronger account controls, and hosting foundation features.
Public licensing now follows the monthly and yearly model
cPanel Redis Manager is available at $4.95 per server per month or $49.50 per server per year, while future milestones expand provider controls, package governance, and commercial Redis hosting features.
v2.0.3
Public baseline release with isolated per-account Redis instances, automatic port assignment, AUTH generation, and core lifecycle controls.
v2.0.4
Foundation rewrite that improved process handling and introduced the installer and migration path used by later releases.
v2.1.0
WHM plugin release with server-wide dashboard, account controls, backup tools, recovery features, and global management foundations.
v2.1.1
Internal hardening release with safer write paths, stronger validation, tighter access control, and audit logging improvements.
v2.2.x
User control and stability series adding monitoring, presets, backup and restore, safe config editing, and stronger health-aware instance handling.
v2.3.x
Hosting foundation series introducing package controls, reseller groundwork, branding, usage history, release hardening, and public observability improvements.
Planned later
Longer-term roadmap themes beyond the next milestone.
These later phases show how Redis Manager is expected to expand after the current hosting-control and monetization milestone.
Security and abuse protection
Resource enforcement, abuse controls, stronger AUTH handling, rate limiting, tracking, and a stronger license model with improved server fingerprinting.
Deep observability and debugging
Advanced graphs, drill-down visibility, debug mode, slowlog tooling, command visibility, improved health scoring, and stronger support telemetry.
Infrastructure upgrade
Background worker framework, restart backoff, auto-healing behavior, orphan cleanup, and system maintenance automation.
Advanced features
Profile systems, config bundles, stronger backup rollback flows, integrity improvements, export and import between servers, and signed configuration validation.
Developer and integration layer
REST API foundation, webhooks, automation events, Redis version management, and external Redis integration.
Enterprise and multi-control-panel support
Shared architecture preparation, DirectAdmin support, and cluster, Sentinel, and scaling-oriented deployment features.
Changelog
Recent releases and what changed in Redis Manager.
Review the latest shipped updates in the public release line, including new features, observability improvements, deployment changes, and public rollout updates.
v2.3.8
2026-04-23 - Historical graphs and public site refresh
- 24-hour and 7-day historical graphs for memory usage, connections, and cache hits versus misses
- server-wide WHM usage rollups for shared-hosting Redis monitoring
- hourly usage collection with cPanel-readable history mirrors
- WHM retention controls for lightweight observability storage
- homepage, screenshots, pricing, and documentation refreshed for the current public rollout
v2.3.7
2026-04-23 - Hardening and release integrity
- public pricing, release messaging, and upgrade guidance aligned with the active public release path
- release checklist added for installer reruns, WHM registration, branding propagation, account discovery, and icon deployment
- WHM global configuration updated to support in-panel upgrades with streamed installer logs
- config verification documented for successful apply, rollback on invalid changes, and deferred apply on stopped instances
v2.3.6
2026-04-22 - Public rollout for the hosting foundation series
- cPanel plugin and WHM plugin shipped together as the public production package
- installer and uninstaller updated for clean redeploys, in-place upgrades, and broken-install recovery
- hosting foundation features promoted publicly, including packages, reseller groundwork, branding, usage history, and centralized licensing
- public commercial rollout established at $4.95 per server per month
Earlier release series
The foundation behind the current public rollout.
Earlier releases introduced the installer, WHM integration, account controls, backup and restore, configuration safety, hosting foundations, and the architecture used by the current Redis Manager package.
v2.3.0 - v2.3.5
Hosting foundation series introducing package controls, reseller groundwork, branding features, usage history foundations, centralized licensing, and stronger migration reliability.
v2.2.0 - v2.2.2
User-control and stability series adding validated configuration editing, backup and restore workflows, health-aware monitoring, and tighter permission enforcement.
v2.1.x
WHM introduction and hardening cycle with server-wide controls, account management, backup and recovery tools, logging improvements, stronger validation, and tighter access control.
v2.0.3 - v2.0.4
Public baseline followed by the foundation rewrite that introduced the installer-driven migration path used by the current Redis Manager architecture.
v2.0.0
First commercial public release, marking the point where UnderHost began offering cPanel Redis Manager as a product for sale.
v1.0.0
Initial internal release used only on UnderHost-managed servers and managed customer environments before the public product line began.
Next step after installation
After deployment, connect Redis to WordPress, Magento, Laravel, custom PHP apps, and other supported workloads.
This documentation covers installation and server management, but the next step is enabling Redis inside the applications that will actually use it. Use the integration guidance for WordPress, WooCommerce, Laravel, Magento, custom PHP sites, APIs, and session-based apps, then follow the roadmap, changelog, and upgrade guide as your deployment evolves.
Application guides
Connect Redis to the applications running on your server.
Once Redis Manager is installed, the next step is connecting your application to the Redis instance created in cPanel. Use the Redis host, port, password, and database details shown in cPanel exactly as provided.
Object cache and store performance
Use Redis for object caching to reduce repeated database queries, improve page speed, and keep busy WordPress and WooCommerce sites more responsive.
Cache, sessions, queues, and rate limiting
Laravel can use Redis for application cache, sessions, queues, and other framework features that benefit from fast in-memory storage.
High-query store optimization
Magento can use Redis to improve caching behavior, backend responsiveness, and repeated data access for larger storefront workloads.
Sessions, cache, and repeated lookups
Custom PHP applications can use Redis for sessions, caching layers, tokens, queues, and other repeated data operations that should stay fast.
Fast app-side caching and session storage
Node and Python applications can use Redis for caching, session storage, queue workflows, and repeated request optimization using the connection details provided by Redis Manager.
Faster repeated responses
Redis can help APIs, admin dashboards, and internal tools reduce backend load and improve response times for repeated requests.
Use the Redis details shown in cPanel
Each Redis instance provides the host, port, password, and database details needed for application setup. Replace the placeholder values below with the exact values shown in Redis Manager.
- Host: 127.0.0.1
- Port: your assigned Redis port
- Password: your Redis AUTH password
- Database: usually 0 unless your app uses another DB index
Redis only helps when the application is configured to use it
Redis Manager provides the Redis service and connection details. Your application must still be configured to use Redis for object caching, sessions, queues, or repeated data access.
Framework snippets
Ready-to-use Redis connection examples
Replace the example values below with the Redis host, port, password, and database shown in your Redis Manager cPanel interface.
wp-config.php example
define('WP_REDIS_HOST', '127.0.0.1');
define('WP_REDIS_PORT', 6379);
define('WP_REDIS_PASSWORD', 'your_redis_password');
define('WP_REDIS_DATABASE', 0);Install a Redis object cache plugin, add these values to wp-config.php, then enable object cache from the WordPress admin area.
.env example
CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis
REDIS_CLIENT=phpredis
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=your_redis_password
REDIS_PORT=6379
REDIS_DB=0Update your Laravel .env file, then clear and rebuild configuration cache if needed.
env.php example
'cache' => [
'frontend' => [
'default' => [
'backend' => 'Cm_Cache_Backend_Redis',
'backend_options' => [
'server' => '127.0.0.1',
'port' => '6379',
'password' => 'your_redis_password',
'database' => '0',
],
],
],
],Magento Redis configuration can vary by version and use case, but this shows the standard cache backend structure.
phpredis example
<?php
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
$redis->auth('your_redis_password');
$redis->select(0);
$redis->set('test_key', 'Hello Redis');
echo $redis->get('test_key');This is the simplest way to connect from a PHP application using the phpredis extension.
redis client example
const { createClient } = require('redis');
const client = createClient({
socket: {
host: '127.0.0.1',
port: 6379
},
password: 'your_redis_password',
database: 0
});
client.on('error', (err) => console.error('Redis Client Error', err));
(async () => {
await client.connect();
await client.set('test_key', 'Hello Redis');
const value = await client.get('test_key');
console.log(value);
await client.quit();
})();Use this pattern for Node applications that need Redis for caching, sessions, or job queues.
redis-py example
import redis
r = redis.Redis(
host='127.0.0.1',
port=6379,
password='your_redis_password',
db=0,
decode_responses=True
)
r.set('test_key', 'Hello Redis')
print(r.get('test_key'))Use this pattern for Python apps, APIs, workers, and background tasks that need Redis access.