CentOS 8 para AlmaLinux 8 no cPanel sem reinstalar
Como os dois são o mesmo RHEL 8, a conversão troca repositórios, chaves e pacotes de release, não a versão do sistema. Veja o procedimento documentado pelo cPanel e um roteiro de validação para fechar a janela com segurança.

Resposta curta: a conversão é feita no lugar, sem reinstalar: com o cPanel na versão mínima exigida pela documentação, você roda o almalinux-deploy.sh, reinicia e valida release, repositórios, pacotes e serviços. CentOS 8 e AlmaLinux 8 são o mesmo RHEL 8.
Neste artigo
Por que CentOS 8 para AlmaLinux 8 não é uma migração de versão
CentOS 8 e AlmaLinux 8 são reconstruções do mesmo código-fonte do RHEL 8. Mesma ABI, mesmo glibc de base, mesmo layout de sistema de arquivos, mesmo dnf, mesmos módulos AppStream. A conversão não sobe de major. Ela troca quem assina e distribui os pacotes.
Isso muda o tipo de risco. Na passagem de CentOS 7 para AlmaLinux 8 você enfrenta troca de Python 2 para Python 3, de OpenSSL 1.0 para 1.1, de yum para dnf e de toolchain, e o cPanel precisa do processo próprio dele para atravessar isso. Aqui não há nada disso. O que pode dar errado está concentrado em três pontos: repositórios, chaves GPG e pacotes que o script de conversão não reconhece.
Por isso a documentação do cPanel trata o caso como conversão no lugar, sem reinstalar o servidor e sem mover contas. O procedimento oficial está em How to Convert from CentOS 8 to AlmaLinux OS, e se apoia no script almalinux-deploy.sh mantido pelo projeto AlmaLinux.
O que a troca de base de pacotes muda de fato
O script substitui os pacotes de identidade da distribuição e reaponta o dnf para os espelhos AlmaLinux. Depois disso, o dnf distro-sync reinstala os pacotes do sistema com a versão assinada pela AlmaLinux. Os binários do cPanel e do EasyApache 4 vêm de repositórios do cPanel. MySQL e MariaDB vêm dos repositórios oficiais de cada fornecedor, gerenciados pelo cPanel. Todos ficam fora do distro-sync de base e não são trocados pela conversão.
| Componente | Antes | Depois | Impacto para o cPanel |
|---|---|---|---|
| Pacote de release | centos-release / centos-linux-release |
almalinux-release |
/etc/redhat-release e /etc/os-release passam a identificar AlmaLinux |
| Repositórios base | arquivos CentOS-*.repo em /etc/yum.repos.d |
arquivos almalinux*.repo |
dnf passa a buscar nos espelhos AlmaLinux |
| Chave GPG | chave CentOS | chave AlmaLinux importada | pacotes base passam a ser verificados pela nova chave |
| Kernel | build CentOS | build AlmaLinux | exige reboot para entrar em uso |
| Pacotes de branding | logos e notas CentOS | equivalentes AlmaLinux | sem efeito operacional |
| Repositórios do cPanel (EA4, cPanel RPMs) | inalterados | inalterados | contas, PHP e Apache seguem como estavam |
| Repositórios de terceiros (EPEL, Imunify e similares) | inalterados | inalterados | precisam ser compatíveis com EL8 genérico, o que normalmente já são |
CloudLinux não entra nesta tabela nem neste procedimento: ele tem caminho de conversão próprio, mantido pela CloudLinux, e o almalinux-deploy.sh não é a ferramenta para esse caso.
O ponto do kernel merece atenção em quem usa Secure Boot. O shim e o kernel passam a ser assinados pela AlmaLinux, e a nova assinatura precisa ser aceita pelo firmware. Em VPS e na maioria das dedicadas com boot legado isso é irrelevante. Em hardware com Secure Boot ativo, confirme antes da janela.
Qual versão do cPanel exigir e o que checar antes da janela
A conversão só é suportada em versões do cPanel & WHM que já reconhecem AlmaLinux como sistema operacional. A versão mínima está declarada na página oficial do cPanel. Confira lá no dia da janela, em vez de confiar em número decorado, e compare com o que está instalado:
/usr/local/cpanel/cpanel -V
cat /etc/redhat-release
uname -r
Se a versão estiver abaixo da exigida, atualize primeiro e só então converta. Não faça as duas coisas na mesma janela: se algo quebrar, você não saberá qual das duas mudanças causou.
/scripts/upcp
Checklist antes de começar:
- Backup completo e testado. Não existe caminho de volta automático depois da conversão. Snapshot do hypervisor é o mais rápido de restaurar. Em dedicada, imagem do disco ou pelo menos backup de contas com o sistema de backup do WHM, mais cópia de
/etc,/var/cpanele/usr/local/cpanel. - Acesso fora de banda. Console do hypervisor, IPMI ou KVM. O passo final é um reboot com kernel novo.
- Espaço em
/boote/var. Odistro-syncbaixa praticamente todo o sistema base de novo, e/bootrecebe mais um kernel. - Sistema CentOS 8 atualizado até onde for possível. O CentOS 8 chegou ao fim em dezembro de 2021 e os espelhos originais saíram do ar. Se
dnffalhar com erro de metadados, seus.repoainda apontam paramirror.centos.org. Reapontar para o vault resolve, mas é uma alteração sua, não parte do procedimento documentado do cPanel. - Inventário de repositórios de terceiros. Liste o que existe em
/etc/yum.repos.dpara saber o que esperar depois.
dnf repolist all
rpm -qa --qf '%{NAME} %{VENDOR}\n' | sort > /root/pacotes-antes.txt
O segundo comando grava cada pacote com o fornecedor. Ele vira a referência para a validação no fim.
Como executar a conversão, passo a passo
Os passos abaixo seguem a documentação do cPanel. Rode como root, de preferência dentro de screen ou tmux: se a sessão SSH cair durante o distro-sync, o processo continua.
Baixar o script do projeto AlmaLinux
curl -O https://raw.githubusercontent.com/AlmaLinux/almalinux-deploy/master/almalinux-deploy.sh
Leia o script antes de executar. Ele é curto o bastante para isso, e é a forma de saber exatamente o que vai mexer no seu /etc/yum.repos.d.
Executar o almalinux-deploy.sh e o que fazer se abortar
bash almalinux-deploy.sh
O script verifica se o sistema é um EL8 suportado, detecta o painel de controle, troca os pacotes de release, importa a chave GPG e sincroniza os pacotes. Se ele abortar logo no início, a causa costuma ser repositório inacessível ou pacote de release inesperado. A mensagem de erro indica qual. Corrija e rode de novo. Que as verificações iniciais não alteram o sistema é leitura nossa do script, não algo que a página do cPanel documenta: confirme no código da versão que você baixou.
Se ele abortar no meio do distro-sync, não reinicie o servidor. Leia o log, resolva o conflito de pacote (normalmente um pacote de terceiro que depende de versão exata de uma biblioteca) e repita a sincronização. Esse caminho de recuperação é orientação nossa, não consta da documentação do cPanel. Reiniciar com o sistema meio convertido é o cenário em que o snapshot passa a ser necessário.
Reiniciar com o kernel AlmaLinux como padrão no GRUB
Antes do reboot, registre quais kernels ficaram instalados e qual é o padrão. Se o kernel CentOS antigo ainda aparecer, ele é uma rota de fuga pelo GRUB. Se não aparecer, a única volta é o snapshot.
rpm -q kernel
grubby --default-kernel
grubby --info=ALL
reboot
Acompanhe pelo console fora de banda. O GRUB deve listar o kernel AlmaLinux como padrão.
Validação item a item antes de encerrar a janela
Não encerre a janela porque o servidor voltou a responder ping. Valide em camadas, do sistema operacional até o serviço que o cliente enxerga.
Como confirmar que o sistema passou a ser AlmaLinux
cat /etc/redhat-release
uname -r
rpm -qa --qf '%{NAME} %{VENDOR}\n' | grep -i centos
dnf repolist
Esperado: release AlmaLinux, kernel com sufixo el8 em execução a partir do pacote AlmaLinux, e dnf repolist sem repositório CentOS ativo. O grep por CentOS no fornecedor deve voltar vazio ou só com pacotes que você consegue explicar. Compare com o inventário salvo:
rpm -qa --qf '%{NAME} %{VENDOR}\n' | sort > /root/pacotes-depois.txt
diff /root/pacotes-antes.txt /root/pacotes-depois.txt
O diff vai mostrar a troca de fornecedor nos pacotes base e algumas saídas e entradas esperadas: centos-release (ou centos-linux-release) e os pacotes de logos CentOS saem, pacotes almalinux-* entram, e kernels novos aparecem. Só o desaparecimento de um pacote fora dessa lista exige investigação.
Como confirmar que o cPanel reconhece o novo sistema
/usr/local/cpanel/cpanel -V
/scripts/upcp
Rodar o upcp depois da conversão é uma recomendação nossa, não um passo obrigatório da página oficial. Ele força o cPanel a reavaliar o sistema operacional e reinstalar o que estiver faltando. Se ele terminar sem erro, a instalação está coerente com o novo SO.
Quais serviços checar depois do reboot
/scripts/restartsrv_httpd --status
/scripts/restartsrv_mysql --status
/scripts/restartsrv_exim --status
/scripts/restartsrv_dovecot --status
/scripts/restartsrv_named --status
systemctl --failed
systemctl --failed precisa voltar vazio. Qualquer unidade falhando depois do reboot e que não falhava antes é consequência da conversão até prova em contrário.
O que testar como cliente antes de encerrar a janela
- Abra um site por domínio de cada versão de PHP em uso no MultiPHP Manager.
- Envie e receba um e-mail por uma conta real, por SMTP autenticado e IMAP.
- Faça login em cPanel e Webmail de uma conta qualquer.
- Confira se o AutoSSL e o renovador de certificados continuam agendados.
| Camada | Comando ou teste | Critério para encerrar |
|---|---|---|
| Release | cat /etc/redhat-release |
AlmaLinux 8.x |
| Kernel | uname -r |
kernel AlmaLinux em execução |
| Repositórios | dnf repolist |
nenhum repositório CentOS ativo |
| Pacotes | diff antes/depois |
troca de fornecedor, mais release, logos e kernel esperados |
| cPanel | /scripts/upcp |
termina sem erro |
| Serviços | systemctl --failed |
vazio |
| Web e PHP | site por versão de PHP | HTTP 200 e conteúdo correto |
| envio e leitura reais | entrega nos dois sentidos |
Como voltar atrás se a conversão falhar
Não há comando de volta para CentOS 8, e voltar também não faria sentido: o CentOS 8 não recebe atualização desde o fim de 2021. A reversão real é restaurar o snapshot ou a imagem feita antes da janela. Por isso o backup é pré-requisito e não recomendação.
Os problemas mais prováveis, em ordem de frequência esperada pelo desenho do processo:
dnfnão consegue baixar metadados antes da conversão. Repositórios CentOS apontando para espelhos desativados. Ajuste os.repoou desative-os temporariamente.- Conflito de dependência no
distro-sync. Pacote de terceiro preso a uma versão específica. Remova ou atualize o pacote, rode a sincronização de novo e reinstale depois. - Servidor não volta do reboot. Se a verificação antes do reboot (
rpm -q kernel,grubby --info=ALL) mostrou o kernel CentOS antigo ainda instalado, escolha-o no menu do GRUB pelo console, suba o sistema e investigue. Se ele não estava lá, ou se não houver saída, restaure o snapshot. - Serviço do cPanel não sobe. Rode
/scripts/upcp --forcee confira o log em/var/cpanel/updatelogs.
Se o objetivo final é chegar a uma base com suporte longo, lembre que o AlmaLinux 8 encerrou o suporte ativo em maio de 2024 e recebe só correções de segurança até março de 2029. A conversão resolve o CentOS 8 sem reinstalar, mas o planejamento da próxima troca de major começa no mesmo dia.
Referências
- Documentação oficial (cpanel) — How to Convert from CentOS 8 to AlmaLinux OS. Consultado em 2026-11-13.