# 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.

> 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.

João Rizzon · 2026-11-14 · Servidores

---

## 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](https://docs.cpanel.net/knowledge-base/general-server-administration/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](https://docs.cpanel.net/knowledge-base/general-server-administration/how-to-convert-from-centos-8-to-almalinux-os/). Confira lá no dia da janela, em vez de confiar em número decorado, e compare com o que está instalado:

```bash
/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.

```bash
/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/cpanel` e `/usr/local/cpanel`.
- **Acesso fora de banda.** Console do hypervisor, IPMI ou KVM. O passo final é um reboot com kernel novo.
- **Espaço em `/boot` e `/var`.** O `distro-sync` baixa praticamente todo o sistema base de novo, e `/boot` recebe 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 `dnf` falhar com erro de metadados, seus `.repo` ainda apontam para `mirror.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.d` para saber o que esperar depois.

```bash
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

```bash
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
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.

```bash
rpm -q kernel
grubby --default-kernel
grubby --info=ALL
```

```bash
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

```bash
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:

```bash
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

```bash
/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

```bash
/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 |
| E-mail | 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:

- **`dnf` não consegue baixar metadados antes da conversão.** Repositórios CentOS apontando para espelhos desativados. Ajuste os `.repo` ou 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 --force` e 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.

