Erro runlevel 5 ao instalar o cPanel: como resolver imprimir

O instalador do cPanel parou com server was in runlevel 5? Veja o que a mensagem significa e como resolver com systemctl set-default multi-user.target.

• Tempo: 5 min
• Nível: Intermediário
• Vale para: AlmaLinux e CloudLinux 8 e 9 (e CentOS 7 ou Rocky antigos)
• Atualizado: outubro de 2026

Ao rodar o instalador do cPanel & WHM, a instalação para logo no começo com estas linhas no terminal e no log:

(ERROR): The installation process detected that the server was in runlevel 5.
(FATAL): The server must be in runlevel 3 before the installation can continue.

Em português: o servidor está no modo gráfico, e o cPanel só instala no modo texto multiusuário. "Runlevel" é o nome antigo dos modos de operação do Linux; nos sistemas com systemd eles se chamam targets. O runlevel 5 corresponde ao graphical.target (com interface gráfica) e o runlevel 3, ao multi-user.target (só texto, rede e serviços). A documentação da cPanel exige o multi-user.target em todas as versões suportadas.

Antes de começar

• Acesso como root pelo SSH ou pelo console.
• Se você está logado na interface gráfica do próprio servidor, a sessão vai ser encerrada. Prefira fazer pelo SSH.

Como resolver

1. Confirme o modo atual.

   systemctl get-default

   Se a resposta for graphical.target, esse é o motivo do erro.
2. Defina o modo texto como padrão.

   systemctl set-default multi-user.target

3. Mude agora ou reinicie. Para trocar de modo sem reiniciar:

   systemctl isolate multi-user.target

   Ou simplesmente reboot. Depois, confira com systemctl get-default e com runlevel, que deve mostrar o número 3 no fim.
4. Rode o instalador de novo.

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

Outros requisitos que costumam barrar o instalador

• Sistema suportado: AlmaLinux, CloudLinux ou Ubuntu 24.04, em versões aceitas pela versão atual do cPanel. O Rocky Linux deixou de ser suportado na versão 134 e o CentOS 7 não recebe mais versões novas do cPanel.
• SELinux desativado: confira com sestatus.
• Hostname completo, como servidor.seudominio.com.br, que não seja o domínio de um site. Defina com hostnamectl set-hostname servidor.seudominio.com.br.
• IP público fixo e pelo menos 2 GB de memória e 20 GB de disco (a cPanel recomenda 4 GB e 40 GB).

O log completo da instalação fica em /var/log/cpanel-install.log. Quando o instalador parar, procure as linhas com ERROR ou FATAL.

Problemas comuns

Mudei para multi-user.target e o erro continua

Confira se o comando foi aceito: systemctl get-default precisa responder multi-user.target, e o servidor precisa ter sido reiniciado (ou passado pelo isolate) antes de rodar o instalador de novo. Em VPS de contêiner antigos (OpenVZ), o modo de operação pode vir do modelo do sistema; nesse caso, peça ao provedor um modelo mínimo, sem interface gráfica.

Perdi a tela gráfica do servidor

É o esperado. Um servidor com cPanel é administrado pelo WHM no navegador (porta 2087) e pelo SSH. Se quiser a interface gráfica de volta numa máquina sem cPanel, use systemctl set-default graphical.target.

A instalação falhou no meio por outro motivo

Corrija o erro apontado no /var/log/cpanel-install.log e rode o instalador de novo. Se o servidor ficou num estado estranho, lembre que a cPanel não oferece desinstalador: o caminho seguro é reinstalar o sistema e começar do zero.