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

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

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

---

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](https://docs.cpanel.net/whm/server-configuration/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:

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

```bash
/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.

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

> **** "Seu servidor recebe atualizações de segurança do painel de hospedagem e do sistema operacional de forma automática, sempre entre 3h e 5h da manhã. Nesse intervalo, o site e o e-mail podem ficar indisponíveis por alguns segundos enquanto os serviços reiniciam. O esperado é que mensagens enviadas nesse momento fiquem na fila e saiam em seguida, e nós conferimos a fila na manhã seguinte para confirmar. Se precisar de alguma data sem manutenção, por conta de campanha ou lançamento, nos avise com antecedência que ajustamos a janela."

E uma versão curta para quem pergunta depois do fato:

> **** "Foi a janela de manutenção automática de segurança, às 3h40. Os serviços reiniciaram e voltaram em seguida. Conferimos a fila do Exim e as mensagens do período saíram normalmente."

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](https://docs.cpanel.net/whm/server-configuration/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.

