Como usar Redis no cPanel em 2026: o Redis por conta em contêiner do EasyApache 4, a extensão redis do PHP pelo PECL e o cuidado com Redis global.
O Redis é um banco de dados em memória muito usado como cache de objetos (WordPress, Magento, Laravel) e para sessões. Em um servidor cPanel há duas partes: o serviço Redis, que guarda os dados, e a extensão redis do PHP, que deixa o site conversar com ele. O tutorial antigo, que instalava o Redis do EPEL no CentOS 7 e compilava a extensão para o PHP 5.6 a 7.2, não serve mais: essas versões estão fora de suporte.
Qual forma de Redis usar no cPanel
| Opção | Como funciona | Quando usar |
|---|---|---|
Redis em contêiner do EasyApache 4 (ea-redis62) ou Valkey (ea-valkey72) | Cada conta cPanel roda o próprio Redis, acessado por um socket na pasta da conta. Mantido pelo cPanel. | Servidores com várias contas. É o caminho suportado pelo cPanel. |
| Redis do sistema (pacote do AlmaLinux ou do Ubuntu) | Um único Redis para o servidor inteiro, na porta 6379. | Servidor de um único dono, com um ou poucos sites. |
Como ativar o Redis por conta (contêiner do EasyApache 4)
- Habilite os contêineres no servidor (como root). No AlmaLinux:
No Ubuntu, instale os mesmos pacotes comdnf install -y ea-podman-repo dnf install -y ea-podmanapt installe rodeapt updatedepois do primeiro. - Dê acesso SSH à conta. O usuário precisa de shell normal (Normal Shell), não o shell restrito (jailed). Isso é feito em WHM » Account Functions » Manage Shell Access.
- Instale o Redis como o usuário da conta. Entre por SSH diretamente com o usuário cPanel (não use
sunemsudoa partir do root) e rode:
O segundo comando mostra o nome do contêiner criado./usr/local/cpanel/scripts/ea-podman install ea-redis62 /usr/local/cpanel/scripts/ea-podman containers - Localize o socket. A aplicação conversa com o Redis pelo arquivo
redis.sock, dentro da pasta do contêiner na home do usuário:find ~ -maxdepth 3 -name 'redis.sock' - Configure a aplicação para usar esse socket (no WordPress, no plugin de cache de objetos; em outras aplicações, no arquivo de configuração do cache), informando o caminho completo do
redis.sock.
ea-redis62 por ea-valkey72. O socket passa a se chamar valkey.sock.Como instalar a extensão redis do PHP
- Pelo WHM: vá em WHM » Software » Module Installers » PHP PECL, escolha a versão do PHP (por exemplo,
ea-php83), clique em Apply, digiteredisno campo Install a PHP Pecl e clique em Install Now. Repita para cada versão de PHP usada pelos sites. - Pela linha de comando, o equivalente para o PHP 8.3 é:
Se o comando reclamar da falta do/opt/cpanel/ea-php83/root/usr/bin/pecl install redisphpize, instale o pacote de desenvolvimento da versão (ea-php83-php-devel) e tente de novo. - Confira e reinicie o PHP-FPM.
/opt/cpanel/ea-php83/root/usr/bin/php -m | grep redis /usr/local/cpanel/scripts/restartsrv_apache_php_fpm
E no CloudLinux?
O cPanel não suporta os contêineres do EasyApache 4 em servidores CloudLinux com CageFS. Nesses servidores, a extensão redis costuma ser ativada pelo próprio cliente em Select PHP Version (PHP Selector), e o serviço Redis vem de soluções do próprio CloudLinux ou de um Redis do sistema configurado com cuidado. Consulte a documentação do CloudLinux para o seu caso.
Redis do sistema, para servidor de um único dono
dnf install -y redis # AlmaLinux 8 e 9
systemctl enable --now redis
redis-cli pingA resposta PONG confirma que está funcionando. Por padrão ele escuta só em 127.0.0.1; mantenha assim. No AlmaLinux 10 o Redis foi substituído pelo Valkey nos repositórios oficiais (pacote valkey).
Problemas comuns
A aplicação diz que a extensão redis não está carregada
A extensão foi instalada em uma versão do PHP e o site usa outra. Veja a versão do domínio no MultiPHP Manager e instale a extensão nela.
O contêiner não volta depois de reiniciar o servidor
Em CloudLinux com CageFS esse comportamento é esperado, porque o CageFS bloqueia o controle de serviços do usuário. Em Virtuozzo, os contêineres exigem o systemctl de usuário habilitado.
