Atualização automática do cPanel: canal, janela e o que reinicia
Como escolher o canal de versão, separar update do painel do update do sistema operacional e marcar a janela de madrugada sem receber ligação do cliente no dia seguinte.

Resposta curta: o cPanel trabalha com canais de versão (LTS, Stable, Release, Current e Edge, conforme a lista da página de Update Preferences) e três modos de atualização. Para frota de clientes, use Stable com atualização automática em janela noturna, lembrando que httpd, Exim, Dovecot e cpsrvd reiniciam durante o processo.
Neste artigo
- LTS, Stable, Release, Current e Edge: qual canal serve a uma agência
- Atualizar o painel não atualiza o sistema operacional
- Quais serviços reiniciam: httpd, exim, dovecot e cpsrvd
- Como fixar a janela em vez de aceitar o horário padrão
- Auditar a frota inteira pelo /etc/cpupdate.conf, sem abrir cada WHM
- Sete itens para conferir antes de ligar o automático
- O que dizer ao cliente antes e depois da janela
- Fonte
O cPanel trabalha com canais de versão (a página de Update Preferences lista LTS, Stable, Release, Current e Edge) e três modos de atualização (automática diária, manual ou nunca). A lista de tiers muda com o tempo, então confirme na documentação da versão que você roda antes de fechar a política. Para uma agência que mantém dez, vinte ou cinquenta VPS, essa combinação precisa ser uma decisão escrita, não uma escolha feita servidor a servidor no dia em que alguém abre o WHM.
O que segue é um processo de padronização apoiado na documentação oficial do cPanel em Update Preferences. Não há medição própria aqui: é organização de tarefa, não benchmark.
LTS, Stable, Release, Current e Edge: qual canal serve a uma agência
O canal (tier) define qual versão do cPanel & WHM o servidor busca quando atualiza. A diferença entre eles é o atraso em relação ao código mais novo, e esse atraso é exatamente o que você está comprando.
| Canal | O que entrega | Quando usar na frota |
|---|---|---|
| LTS | Versão de suporte estendido, a mais conservadora | Servidor com stack travado, cliente que não tolera mudança de comportamento |
| Stable | Versão promovida depois de passar por Release | Padrão sensato para a maioria dos VPS de produção |
| Release | Versão corrente recomendada pelo cPanel | Quando você precisa de recurso ou suporte a SO novo antes do Stable |
| Current | Linha mais nova já promovida, à frente de Release | Fora da recomendação para frota de clientes; serve em servidor de homologação |
| Edge | Código mais recente, antes da promoção a Release | Só em servidor de teste. Nunca em site de cliente |
A documentação também permite fixar uma versão específica em vez de um canal. Isso congela o servidor em um ponto do tempo e transfere para você a responsabilidade de sair de lá antes do fim de vida daquela linha. É útil para um caso pontual, é péssimo como padrão de frota, porque vira um servidor esquecido.
Recomendação honesta: Stable para produção, Release quando houver motivo declarado, LTS para exceção documentada. Edge fica fora da frota de clientes. Se você mantém um VPS interno para homologar temas e plugins, aponte esse para Release ou Edge e use-o para descobrir quebras antes dos clientes.
Atualizar o painel não atualiza o sistema operacional
A tela de Update Preferences trata de coisas separadas, e confundir as duas é a origem de metade das discussões sobre "o servidor atualizou sozinho".
- cPanel & WHM Updates: atualiza o painel, os serviços gerenciados por ele e o ecossistema cPanel. É aqui que entra a escolha de canal.
- Operating System Package Updates: atualiza pacotes do sistema via gerenciador de pacotes da distribuição. Pode estar automático, manual (disparado pelo processo de atualização do cPanel) ou desligado.
- Apache SpamAssassin Rule Updates: atualização das regras de anti-spam, independente dos dois anteriores.
Três decisões, três linhas na sua política. O erro comum é deixar o painel em automático e o sistema operacional em "never" por anos: o resultado é um servidor com cPanel novo rodando sobre pacotes sem correção de segurança. O inverso também acontece, e aí o cPanel fica para trás até parar de ser suportado na distribuição.
Troca de versão maior do sistema operacional (CentOS 7 para AlmaLinux 8, por exemplo) não acontece por essa tela. É projeto à parte, com janela própria e plano de retorno.
Quais serviços reiniciam: httpd, exim, dovecot e cpsrvd
Esta é a parte que determina o horário da janela. Uma atualização do cPanel não é transparente: serviços são reiniciados conforme são atualizados.
| Serviço | Impacto visível para o cliente |
|---|---|
httpd (Apache/EA4) |
Sites ficam indisponíveis por segundos durante o restart |
exim |
E-mail enviado no instante do restart é reenfileirado, não perdido |
dovecot |
Clientes IMAP/POP caem e reconectam; webmail pode dar erro momentâneo |
cpsrvd |
WHM, cPanel e Webmail ficam fora do ar por instantes |
mysql / mariadb |
Só quando há atualização do banco; é a pausa mais longa |
O que a página de Update Preferences sustenta é o essencial: a atualização reinicia serviços do cPanel enquanto roda. O detalhamento por serviço na tabela (fila do Exim segurando a mensagem, cliente IMAP reconectando, pausa maior quando há upgrade de banco) é comportamento conhecido desses daemons em operação, não está escrito naquela página e não é medição nossa. Trate como expectativa, confirme no seu ambiente e só então prometa prazo ao cliente.
Na prática são interrupções curtas e sequenciais, não uma parada única e longa. Mas "curto" e "às 14h de uma terça" não combinam quando o cliente tem loja, formulário de lead ou sistema de pedidos. O impacto que o cliente percebe raramente é o site fora: é o checkout que falhou uma vez e o e-mail que demorou.
Se o servidor roda algo pesado fora do cPanel (um worker, um cron longo, uma importação), inclua isso na avaliação. Um httpd reiniciando no meio de um import de 40 mil produtos deixa lixo no banco.
Como fixar a janela em vez de aceitar o horário padrão
Deixar "Automatic" ligado sem controlar o horário significa aceitar o agendamento padrão do cron de manutenção do servidor. Para uma agência, isso é imprevisível na hora de explicar ao cliente por que o webmail piscou.
Duas abordagens, escolha uma e aplique na frota inteira:
Manter o automático e ajustar o cron do cPanel, que pode ser reescrito
Mantenha as atualizações automáticas e ajuste o agendamento da tarefa de atualização do cPanel no cron do sistema para a madrugada do fuso do cliente. Vale conferir o conteúdo atual antes de mexer:
cat /etc/cron.d/cpanel
cat /etc/cpupdate.conf
Um aviso que economiza uma madrugada perdida: /etc/cron.d/cpanel é gerado e mantido pelo próprio cPanel, e a atualização pode reescrever o arquivo sem avisar, devolvendo o horário ao padrão. Se o seu objetivo é horário fixo e garantido, o caminho previsível é desligar a atualização automática do painel e agendar o upcp no seu próprio cron (a opção B abaixo), que nada do cPanel sobrescreve. Se mesmo assim preferir ajustar o arquivo do cPanel, confirme na documentação da sua versão qual chave de /etc/cpupdate.conf ou qual opção do WHM controla o agendamento, e valide depois: na manhã seguinte à primeira atualização automática, rode cat /etc/cron.d/cpanel de novo e compare com o que você deixou escrito. Se voltou ao padrão, a janela não é sua.
É a opção de menor manutenção. Você garante que o servidor não fica para trás e que o barulho acontece de madrugada.
Deixar em manual e agendar o upcp no seu próprio cron
Coloque as atualizações do cPanel em manual e dispare a atualização na janela combinada:
/usr/local/cpanel/scripts/upcp
Para acompanhar o resultado sem ficar preso ao terminal, rode dentro de screen ou tmux e revise o log ao final. Essa opção dá controle total e cobra disciplina: alguém da equipe precisa ter a tarefa no calendário, ou o servidor para de atualizar.
Minha preferência para frota grande é a opção A com janela noturna, e a opção B reservada para os três ou quatro servidores críticos onde a agência quer olhar o resultado no mesmo dia.
Auditar a frota inteira pelo /etc/cpupdate.conf, sem abrir cada WHM
A configuração que você define na interface do WHM é gravada em /etc/cpupdate.conf. Isso permite auditar a frota inteira em um loop, antes de decidir o que mudar.
# auditoria: ver a política atual de cada servidor
for h in vps01 vps02 vps03; do
echo "== $h"
ssh root@$h 'cat /etc/cpupdate.conf'
done
A saída mostra o canal e os modos de atualização de cada máquina. Com isso em mãos você descobre rápido os desvios: o servidor que alguém deixou em manual em 2023, o que está preso em uma versão fixa, o que está com atualização de pacotes do sistema desligada.
Para aplicar a mudança, prefira a interface do WHM ou a API do cPanel a editar o arquivo na mão em produção. Se optar por editar, faça backup do arquivo antes e valide a mudança abrindo a tela de Update Preferences em pelo menos um servidor, comparando o que a interface mostra com o que você escreveu. A documentação oficial é a referência para os valores aceitos em cada chave.
Guarde a política em um documento curto no repositório da agência, com três linhas por grupo de servidores: canal, modo de update do painel, modo de update do sistema operacional. Quando entrar gente nova no time, ela aplica a política sem perguntar.
Sete itens para conferir antes de ligar o automático
- Backup recente e testado. Atualização automática sem backup verificado é aposta.
- Conferir se há notificação por e-mail ativa para falha de atualização. Atualização silenciosa que falha é pior que atualização manual esquecida.
- Verificar espaço em disco. Atualização que enche o
/deixa serviço fora do ar até alguém intervir. - Confirmar a versão do sistema operacional e se ela ainda é suportada pelo canal escolhido.
- Para sites com cron pesado, cruzar o horário do cron com a janela de atualização.
- Avisar o cliente antes da primeira janela, não depois.
- No dia seguinte à primeira atualização automática, abrir os sites principais, enviar um e-mail de teste, conferir a fila do Exim (
exim -bpc) e checar o log de atualização.
O item 7 é o que mais se pula e o que mais evita surpresa. Um plugin que quebra com PHP novo aparece em cinco minutos de conferência e em três dias de reclamação do cliente.
O que dizer ao cliente antes e depois da janela
Quando a agência avisa antes, o cliente trata como manutenção. Quando descobre sozinho, trata como incidente. Use algo assim, adaptando horário e nome:
E uma versão curta para quem pergunta depois do fato:
A última frase do aviso, sobre ajustar a janela para campanha, é a que mais rende: transforma uma política técnica em serviço percebido, e evita a atualização que roda justo na madrugada da virada do Black Friday.
Fonte
- cPanel, Update Preferences (WHM > Server Configuration), consultado em 07/10/2026. Os valores aceitos em cada opção e o comportamento de cada modo devem ser confirmados nessa página para a versão que você roda.
Referências
- Documentação oficial (cpanel) — Update Preferences. Consultado em 2026-10-07.