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

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

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

---

## 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](https://docs.cpanel.net/installation-guide/system-requirements-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ão `yum`/`dnf`. Qualquer script interno da agência que chame `yum install` em 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 `ufw` como frontend padrão. Defina quem manda nas regras (o painel, o `ufw` ou 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-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.
- 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.
- `hostnamectl` e ajustar para um FQDN dedicado ao servidor.
- `df -h /` para conferir espaço livre, e revisar o particionamento entregue pelo provedor.
- `snap list` e revisar o que o provedor pré-instalou; remover o que toca a stack web.
- Revisar o `cloud-init` da 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:

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

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

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

> **** "O cPanel só é suportado em versões específicas de Ubuntu e exige um servidor sem nada instalado antes. O seu está fora de uma dessas duas condições. Vamos recriar a máquina com a versão que o fabricante do painel indica e seguir com a migração. Nada do site se perde: o conteúdo está no backup e entra depois da instalação."

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.

