Como converter um servidor cPanel para CloudLinux com cldeploy imprimir

Como converter um servidor cPanel com AlmaLinux para CloudLinux usando o cldeploy: licença, checagem prévia, conversão, reboot e ativação do CageFS.

• Tempo: 30 a 60 min, com um reinício
• Nível: Avançado
• Vale para: AlmaLinux 8, 9 e 10 com cPanel e WHM 134 a 138
• Atualizado: outubro de 2026

O CloudLinux é uma distribuição baseada no mesmo código do AlmaLinux, feita para hospedagem compartilhada. Ele isola cada conta (CageFS), limita CPU, memória e processos por usuário (LVE), oferece várias versões de PHP por conta (PHP Selector) e impede que um site com problema derrube o servidor inteiro. A conversão é feita no próprio servidor, sem reinstalar, com o script oficial cldeploy.

Antes de começar

• Sistema de origem suportado: AlmaLinux 8, 9 ou 10 (e Rocky Linux 8 ou 9). CentOS 8, CentOS Stream e Rocky Linux 10 não são aceitos.
• Licença do CloudLinux, por chave de ativação ou registrada no IP do servidor. Pelo próprio WHM você pode comprar e instalar em um passo, no botão Upgrade to CloudLinux da página inicial.
• Backup testado das contas, bancos de dados e configurações. A conversão troca o kernel e pacotes do sistema.
• Acesso ao console do servidor (IPMI, KVM ou painel da VPS), para o caso de o servidor não voltar do reboot.

Como converter o servidor cPanel para CloudLinux

1. Baixe o cldeploy do repositório oficial:

   cd /root
   wget https://repo.cloudlinux.com/cloudlinux/sources/cln/cldeploy

2. Rode a checagem prévia. Ela não muda nada no servidor; só testa se a conversão é possível:

   bash cldeploy --precheck

   O resultado fica em /var/log/cldeploy-precheck.log. Resolva o que aparecer como erro antes de seguir.
3. Converta. Com chave de ativação:

   bash cldeploy -k SUA_CHAVE_DE_ATIVACAO

   Com licença registrada no IP do servidor:

   bash cldeploy -i

   Em servidores cPanel o script também instala os componentes de integração com o painel. Use uma sessão tmux para não perder o processo se o SSH cair.
4. Reinicie no fim da conversão e confira o sistema e o kernel em uso:

   reboot
   cat /etc/redhat-release
   uname -r

   O primeiro comando deve mostrar CloudLinux; o segundo, o kernel instalado pela conversão.
5. Ative o CageFS, se ainda não estiver ativo.

   dnf -y install cagefs
   /usr/sbin/cagefsctl --init
   /usr/sbin/cagefsctl --enable-all

6. Revise no WHM. Entre no WHM e abra a interface CloudLinux Manager (use a busca do menu lateral). Ali ficam os limites por conta (LVE), o CageFS e o PHP Selector.
7. Teste os sites. Abra alguns sites, faça login em um WordPress e teste o envio de e-mail antes de encerrar a manutenção.

Depois da conversão: PHP por conta

Com CloudLinux, cada cliente pode escolher a versão do PHP e as extensões no cPanel, em Select PHP Version (PHP Selector). Isso convive com o MultiPHP Manager do WHM, mas vale decidir qual dos dois você vai usar como padrão. Veja também como mudar o PHP handler no WHM.

Problemas comuns

A checagem prévia acusa sistema não suportado

A versão de origem não está na lista (por exemplo, CentOS 7, CentOS Stream ou Rocky 10). No caso do CentOS 7, o cPanel atual nem instala mais; migre antes para AlmaLinux, como explicado em fim de vida do CentOS.

Erro de registro da licença

Com -i, a licença precisa estar emitida para o IP público do servidor. Atrás de NAT, use a chave de ativação com -k.

Sites lentos ou com erro 508 depois da conversão

Os limites padrão de LVE ficaram baixos para algum site. Ajuste os limites da conta no CloudLinux Manager.