blog
Servidores

cPanel no Ubuntu: os 2 requisitos que travam a instalação

O instalador existe, mas a lista de versões LTS aceitas pode mudar entre releases e a exigência de servidor limpo elimina boa parte dos VPS já contratados. Como conferir em 15 minutos.

JR · · 7 min de leitura · 1 tabela · 2 blocos de código

Resposta curta: sim, o cPanel & WHM tem instalador para Ubuntu Server, mas só nas versões LTS listadas na página oficial de requisitos e apenas em servidor limpo, sem painel anterior e com hostname FQDN. A lista pode mudar entre releases, então confira a data da página antes de instalar.

Neste artigo
  1. Sim, desde que a LTS esteja na lista e o servidor esteja limpo
  2. Leia a matriz de versões em vez de decorar o número
  3. Os pré-requisitos que invalidam um VPS já em uso
  4. O que muda em relação a AlmaLinux e CloudLinux
  5. Checklist de 15 minutos antes de rodar o instalador
  6. A frase para o cliente que já contratou o VPS fora dos requisitos
  7. Quando a resposta certa é não usar Ubuntu

Sim, desde que a LTS esteja na lista e o servidor esteja limpo

O cPanel & WHM tem instalador para Ubuntu Server. A condição é a versão: a cPanel publica uma página de requisitos específica para Ubuntu e lista ali qual release LTS a versão corrente do painel aceita. Se o seu VPS está numa LTS que não consta nessa lista, o instalador não é um caminho de "tentar e ver": é cenário não suportado conforme a página de requisitos.

O erro caro não é escolher Ubuntu. É descobrir a restrição com o site do cliente já dentro da máquina, migrado às pressas de uma hospedagem compartilhada numa sexta-feira. O conteúdo abaixo é procedimento documental: tudo que afirmo sobre requisitos sai da página oficial de requisitos de sistema para Ubuntu, consultada em 09/10/2026. Nada aqui é medição nossa, e a página pode mudar entre ciclos de release, então o passo zero é sempre reabrir a URL e olhar a data.

Leia a matriz de versões em vez de decorar o número

Fixar "Ubuntu X suportado" num documento interno da agência é o jeito mais rápido de errar daqui a um ano. A cPanel acrescenta e aposenta releases de sistema operacional conforme o fim de vida de cada distribuição e o próprio ciclo de versões do painel (as faixas TIER). Quem mantém trinta sites de clientes precisa de um processo de conferência, não de um número memorizado.

O processo, em três leituras da mesma página:

  1. Qual LTS consta como suportada. A página de requisitos para Ubuntu traz a relação de versões aceitas. Anote qual delas aparece hoje e em que data você leu.
  2. Qual versão do cPanel aceita aquela LTS. Suporte a um sistema operacional costuma entrar numa faixa de release antes de chegar às demais. Confirme se a faixa que você usa em produção já contempla a versão.
  3. A seção de limitações. A mesma página documenta o que não funciona ou não está disponível nessa plataforma. É a seção que a maioria pula e a que determina se o projeto do cliente cabe ali.

Registre as três respostas com a data da consulta num arquivo do time. Na próxima instalação, a pergunta deixa de ser "dá pra usar Ubuntu" e vira "a anotação tem mais de noventa dias, então reconfere".

As três leituras da página de requisitosVersão LTSConsta na lista oficial hojeFaixa de releaseSua faixa cPanel aceita a versãoLimitaçõesConfronte com o escopo do cliente
Três leituras da mesma página de requisitos, com a data da consulta anotada.

Os pré-requisitos que invalidam um VPS já em uso

A instalação do cPanel pressupõe servidor limpo. Não é recomendação de estilo: é requisito. Um VPS que já rodou outra coisa é candidato a reinstalação, não a adaptação.

Condição encontrada no VPS Efeito prático
Outro painel instalado (Plesk, CyberPanel, HestiaCP, Webmin) Cenário não suportado. Reinstale o sistema operacional do zero
Stack web já montada na mão (Apache, Nginx, MySQL, PHP via apt) Conflita com o que o instalador provisiona. Servidor limpo
Versão de Ubuntu fora da lista da página de requisitos Instalação não suportada. Trocar o template do sistema operacional
Hostname sem FQDN válido (ex.: ubuntu, vps1) Corrigir antes de rodar o instalador
Pacotes de conveniência do provedor via Snap ou cloud-init customizado Revisar e remover o que interfere na stack web antes de começar

Três detalhes que valem checagem antes de qualquer download:

O que muda em relação a AlmaLinux e CloudLinux

Quem só instalou cPanel em base Red Hat carrega automatismos que não valem aqui. O inventário abaixo é de pontos a verificar na documentação antes de prometer ao cliente, não de afirmações fechadas, porque cada um deles pode mudar de status entre releases:

Checklist de 15 minutos antes de rodar o instalador

Rode na ordem. Qualquer "não" nos itens 2 e 4 significa reinstalar o sistema operacional, e é melhor descobrir agora. Um não no item 3 é mais barato: resolve-se mudando a faixa de release do cPanel, sem tocar no sistema.

  1. Abrir a página de requisitos para Ubuntu e anotar a data da consulta.
  2. cat /etc/os-release e comparar o VERSION_ID com a lista da página. O lsb_release -a serve como alternativa, mas o pacote lsb-release costuma faltar em imagem mínima.
  3. Confirmar que a faixa de release do cPanel que você usa aceita essa versão.
  4. Confirmar que o servidor está limpo: sem painel anterior, sem stack web instalada.
  5. hostnamectl e ajustar para um FQDN dedicado ao servidor.
  6. df -h / para conferir espaço livre, e revisar o particionamento entregue pelo provedor.
  7. snap list e revisar o que o provedor pré-instalou; remover o que toca a stack web.
  8. Revisar o cloud-init da imagem, para que ele não sobrescreva hostname ou rede depois do boot.
  9. Decidir quem controla o firewall e documentar a decisão.
  10. Ler a seção de limitações e confrontar com o escopo contratado pelo cliente.

Validação rápida dos itens 2, 5, 6 e 7:

cat /etc/os-release
hostnamectl
df -h /
snap list

Se hostnamectl devolver algo como ubuntu ou vps-01, ajuste antes:

hostnamectl set-hostname srv01.suaagencia.com.br

O exemplo de hostname é fictício: troque pelo domínio que a agência usa para infraestrutura, nunca pelo domínio do site que vai ser hospedado.

O que fazer quando o checklist falhaVersão fora da listaRecriar VPS com versão suportadaServidor não está limpoReinstalar sistema operacional do zeroFaixa de release antigaMudar faixa, sem tocar no sistemaHostname sem FQDNAjustar com hostnamectl antesTudo conferidoRodar o instalador
Caminho de decisão a partir do checklist, do bloqueio mais caro ao mais barato.

A frase para o cliente que já contratou o VPS fora dos requisitos

Quando o item 2 ou o item 4 falha, o cliente precisa autorizar uma reinstalação do sistema operacional, e geralmente ele leu em algum lugar que "é só instalar". Use uma frase curta, sem jargão e sem culpar ninguém:

Se houver cobrança envolvida, deixe explícito que o retrabalho vem de uma restrição do fornecedor do painel e aponte a página oficial. É mais rápido mandar o link do que debater.

Quando a resposta certa é não usar Ubuntu

Vale dizer contra o próprio reflexo: se o VPS já está vazio e o provedor oferece as duas opções, uma distribuição base Red Hat suportada continua sendo o caminho com menos arestas para cPanel, porque é onde a maior parte da documentação, dos tutoriais e dos scripts de terceiros foi escrita. Escolher Ubuntu faz sentido quando existe um motivo concreto: padronização do restante da infraestrutura do cliente, dependência de pacote que só existe bem ali, exigência de uma equipe interna.

E se a versão que o cliente contratou não consta na lista, há três saídas, em ordem de custo:

Seja qual for a escolha, repita o passo zero antes da próxima instalação: reabra a página de requisitos, confira a data, anote. A matriz muda, e o único jeito de não errar é não confiar na memória, incluindo a deste artigo.

Referências

  1. Documentação oficial (cpanel) — System Requirements (Ubuntu). Consultado em 2026-10-09.
Leia também