Como instalar o cPanel e WHM em 2026: requisitos e passo a passo imprimir

Como instalar o cPanel e WHM em 2026: sistemas suportados, requisitos de hardware, comando oficial de instalação e primeiros passos no WHM.

• Tempo: 30 a 60 min (a maior parte é espera)
• Nível: Intermediário
• Vale para: cPanel e WHM 134 (LTS) a 138 em AlmaLinux 8, 9 e 10, CloudLinux 8, 9 e 10 e Ubuntu 24.04
• Atualizado: outubro de 2026

A instalação do cPanel é feita por um único script oficial, que baixa e configura tudo: Apache (EasyApache 4), PHP, MySQL ou MariaDB, Exim, Dovecot, DNS e o próprio WHM. O segredo para dar certo de primeira é preparar o servidor antes: sistema suportado, instalação limpa e hostname correto.

Antes de começar: requisitos do cPanel em 2026

• Sistemas suportados para instalação nova: AlmaLinux 8, 9 e 10 (o 10 a partir da versão 132), CloudLinux 8, 9 e 10 (o 10 a partir da 134) e Ubuntu 24.04 LTS. Não há suporte a ARM.
• Fora da lista: o Rocky Linux deixou de ser suportado na versão 134, o Ubuntu 22.04 na 136 e o CentOS 7 / CloudLinux 7 na 112. Para esses casos, instale em AlmaLinux. Se o servidor já roda CentOS antigo, veja como migrar no artigo sobre fim de vida do CentOS e migração para AlmaLinux.
• Sistema recém-instalado e mínimo. Não instale Apache, PHP, MySQL ou painel nenhum antes: o instalador do cPanel precisa encontrar o servidor limpo.
• Hostname no formato de nome completo (FQDN), com até 60 caracteres, que aponte para o IP do servidor e que não seja o domínio de um site que você vai hospedar. Exemplo: servidor.seudominio.com.br.
• Licença: o cPanel é pago. Em servidor novo você pode ativar uma licença de teste de 15 dias pela tela inicial do WHM, depois da instalação.
• Acesso root por SSH. Se precisar de ajuda com isso, veja como acessar o SSH do servidor como root.

Passo a passo da instalação

1. Atualize o sistema e reinicie. No AlmaLinux ou CloudLinux:

   dnf -y update && reboot

   No Ubuntu 24.04:

   apt update && apt -y full-upgrade && reboot

2. Defina o hostname. Troque pelo nome do seu servidor e confira:

   hostnamectl set-hostname servidor.seudominio.com.br
   hostname -f

   Crie também o registro A desse nome apontando para o IP do servidor, na zona DNS do domínio.
3. Abra uma sessão que sobreviva a quedas de conexão. A instalação demora, e se o SSH cair no meio o processo pode ser interrompido. Use o tmux (no AlmaLinux 9 e 10 o screen não vem mais nos repositórios padrão):

   dnf -y install tmux     # no Ubuntu: apt -y install tmux
   tmux new -s cpanel

4. Rode o instalador oficial. Este é o comando publicado pela própria cPanel:

   cd /home && curl -o latest -L https://securedownloads.cpanel.net/latest && sh latest

   Ele baixa a versão do tier padrão (RELEASE) e instala tudo. Se a conexão cair, entre de novo por SSH e volte à sessão com tmux attach -t cpanel.
5. Acompanhe o log, se quiser. Em outra janela:

   tail -f /var/log/cpanel-install.log

   Ao final aparece a mensagem de que a instalação terminou e o endereço do WHM.

Primeiro acesso ao WHM depois da instalação

1. Acesse o WHM. No navegador, abra https://203.0.113.10:2087 (troque pelo IP do servidor), aceite o aviso de certificado do primeiro acesso e entre com o usuário root e a senha do root.
2. Aceite os termos e ative a licença. Na tela de boas-vindas o WHM pede para ler o contrato e, se o servidor ainda não tem licença, oferece o teste de 15 dias pela cPanel Store.
3. Preencha o e-mail de contato e os nameservers. O e-mail recebe os alertas do servidor. Os nameservers podem ser ajustados depois; veja como configurar o DNS padrão no WHM.
4. Revise as portas do firewall. O acesso ao cPanel, WHM e webmail usa portas próprias. A lista completa está em portas usadas pelo cPanel e WHM.

Problemas comuns na instalação do cPanel

The installation process detected that the server was in runlevel 5

O sistema foi instalado com interface gráfica. O cPanel exige servidor sem ambiente de desktop. A solução está no artigo sobre o erro de runlevel 5 no instalador do cPanel.

cPanel has temporarily disabled updates on the central httpupdate servers

O servidor de distribuição recusou o download naquele momento. Veja as causas e o que conferir em erro cPanel has temporarily disabled updates.

O instalador recusa o sistema operacional

Versão fora da lista de suporte (Rocky Linux, Ubuntu 22.04, CentOS 7, AlmaLinux sem atualizar) ou instalação que não está limpa. Reinstale o servidor com AlmaLinux 9 ou 10 mínimo e repita o processo.

Aviso de hostname inválido ou que não resolve

O nome precisa ser um FQDN que aponte para o IP do servidor. Corrija o registro A e o hostname. Depois de instalado, troque o hostname pelo WHM » Networking Setup » Change Hostname (ou pelo utilitário /usr/local/cpanel/bin/set_hostname), nunca só pelo hostnamectl.

Perguntas frequentes

Posso instalar o cPanel no Rocky Linux?

Não em 2026. A cPanel removeu o suporte ao Rocky Linux 8 e 9 na versão 134 e recomenda migrar para o AlmaLinux.

Quanto tempo leva a instalação?

Depende do disco, da CPU e da rede. Em um servidor com SSD costuma levar menos de uma hora. Não interrompa o processo no meio.

Preciso de dois IPs?

Não para instalar. Um IP público fixo basta. Dois IPs só ajudam se você quiser nameservers próprios em endereços diferentes.