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.

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
- Sim, desde que a LTS esteja na lista e o servidor esteja limpo
- Leia a matriz de versões em vez de decorar o número
- Os pré-requisitos que invalidam um VPS já em uso
- O que muda em relação a AlmaLinux e CloudLinux
- Checklist de 15 minutos antes de rodar o instalador
- A frase para o cliente que já contratou o VPS fora dos requisitos
- 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:
- 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.
- 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.
- 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".
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:
- Hostname FQDN. O servidor precisa de um nome totalmente qualificado, no formato
srv01.dominiodaagencia.com.br, e que não seja o domínio principal de um site que vai ser hospedado ali. Trocar depois dá trabalho. - Particionamento e filesystem. Verifique na página de requisitos qual layout e quais sistemas de arquivos são aceitos antes de aceitar o particionamento automático do provedor. Template de VPS costuma vir com uma partição única, o que normalmente serve, mas vale conferir espaço livre em
/antes, porque instalador cheio no meio do caminho é o pior tipo de erro. - Imagem do provedor. Muitos marketplaces entregam "Ubuntu LTS" com camadas próprias: agente de monitoramento, firewall gerenciado, pacotes via Snap. Peça ao provedor uma imagem mínima da versão que a documentação lista, não a imagem otimizada da loja.
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:
- EasyApache 4 e repositórios. O gerenciamento de pacotes do sistema é
apt, nãoyum/dnf. Qualquer script interno da agência que chameyum installem pós-instalação precisa ser reescrito. Confirme na página de requisitos como os repositórios do cPanel são configurados nessa plataforma. - CloudLinux e LVE. Se o seu modelo de revenda depende de limites por conta via LVE, essa é a primeira pergunta a fazer, e a resposta vem da documentação de requisitos e do fornecedor do CloudLinux, não de um fórum de 2019.
- Firewall. O Ubuntu traz
ufwcomo frontend padrão. Defina quem manda nas regras (o painel, oufwou o firewall da camada do provedor) antes de abrir portas, para não terminar com duas camadas se contradizendo. - Recursos listados como indisponíveis. A seção de limitações da página de requisitos é a única fonte confiável sobre o que não existe nessa plataforma. Leia item por item e compare com o que o contrato do cliente promete.
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.
- Abrir a página de requisitos para Ubuntu e anotar a data da consulta.
cat /etc/os-releasee comparar oVERSION_IDcom a lista da página. Olsb_release -aserve como alternativa, mas o pacotelsb-releasecostuma faltar em imagem mínima.- Confirmar que a faixa de release do cPanel que você usa aceita essa versão.
- Confirmar que o servidor está limpo: sem painel anterior, sem stack web instalada.
hostnamectle ajustar para um FQDN dedicado ao servidor.df -h /para conferir espaço livre, e revisar o particionamento entregue pelo provedor.snap liste revisar o que o provedor pré-instalou; remover o que toca a stack web.- Revisar o
cloud-initda imagem, para que ele não sobrescreva hostname ou rede depois do boot. - Decidir quem controla o firewall e documentar a decisão.
- 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.
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:
- Recriar o VPS com uma versão suportada (menor custo quando a máquina ainda está vazia).
- Manter o Ubuntu e usar outro painel compatível, revendo o que muda no fluxo de backup e no acesso do cliente.
- Manter o Ubuntu sem painel, só para quem tem processo de deploy próprio e não vai entregar acesso visual ao cliente final.
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
- Documentação oficial (cpanel) — System Requirements (Ubuntu). Consultado em 2026-10-09.