# Upgrade do Plesk: o que cai e o que fica no ar

O que realmente fica indisponível na janela, o pré-check que evita cancelar no meio e o checklist de validação por assinatura depois que o autoinstaller termina.

> a indisponibilidade esperada no upgrade do Plesk é do painel (porta 8443) e do webmail, não dos sites e do e-mail, que seguem no ar com reinícios curtos quando Apache/nginx, PHP-FPM, Postfix ou o banco são atualizados. Com snapshot antes e log acompanhado, a janela é previsível.

João Rizzon · 2026-11-03 · Painéis

---

## O que cai e o que continua no ar durante o upgrade

A confusão que trava a marcação da janela é tratar "atualizar o Plesk" como "derrubar o servidor". Não é a mesma coisa. O autoinstaller atualiza os componentes do painel e os pacotes que ele gerencia; a indisponibilidade esperada é a **do painel**, na porta 8443, enquanto o Plesk se reinicia e aplica as migrações internas.

Os serviços de produção (Apache/nginx, PHP-FPM, Postfix/Dovecot, MySQL/MariaDB) continuam servindo, exceto nos momentos em que o próprio upgrade atualiza um desses pacotes e reinicia o serviço correspondente. Aí a queda é de segundos a poucos minutos, por serviço, não do servidor inteiro.

Traduzindo para o que você precisa escrever na janela de manutenção:

| Componente | Comportamento esperado | Quem percebe |
|---|---|---||
| Painel Plesk (8443) | Indisponível durante boa parte do upgrade | Você, o cliente que acessa o painel |
| Sites HTTP/HTTPS | No ar, com reinícios curtos do web server | Visitante, se cair bem no reinício |
| PHP-FPM (pools por site) | Reinício por versão de PHP atualizada | Sites dinâmicos, requisições em voo |
| E-mail (SMTP/IMAP) | No ar, com reinício curto se Postfix/Dovecot forem atualizados | Cliente de e-mail reconecta sozinho |
| Banco de dados | No ar; reinício se houver atualização do servidor MySQL/MariaDB | Site cai em erro de conexão durante o reinício |
| Webmail (Roundcube/Horde) | Pode ficar indisponível enquanto o componente é atualizado | Cliente que usa webmail |

Não prometa ao cliente "zero downtime". Prometa **indisponibilidade parcial e curta, em janela combinada**. É o que a arquitetura entrega e é o que você consegue sustentar depois.

### Texto pronto do aviso de manutenção para o cliente final

> **** Vamos fazer uma manutenção programada no servidor no dia DD/MM, entre HH:MM e HH:MM. O site e os e-mails continuam funcionando; pode haver uma ou outra interrupção de poucos segundos durante o processo. O painel de controle e o webmail podem ficar indisponíveis dentro dessa janela. Não é necessária nenhuma ação da sua parte.

Troque data e horário, mande por e-mail e guarde o envio. Isso evita a maior parte da fricção quando alguém abre o site no meio da janela e vê um erro de 20 segundos.

## Conferir se o sistema operacional ainda é suportado pela versão de destino

O erro mais caro não é o upgrade falhar. É o upgrade **não começar** porque o sistema operacional do servidor saiu da lista de suportados da versão de destino do Plesk, e você descobrir isso com a janela aberta e o cliente avisado.

Antes de agendar qualquer coisa, confira na documentação oficial do Plesk a matriz de sistemas operacionais suportados pela versão para a qual você vai subir: o Deployment Guide do Plesk Obsidian traz essa lista na seção de requisitos de instalação ([docs.plesk.com/en-US/obsidian/deployment-guide/](https://docs.plesk.com/en-US/obsidian/deployment-guide/), consultado em 2026-11-01). Um servidor em distribuição fora de suporte pode continuar rodando a versão atual do Plesk e simplesmente não receber a nova.

Levante o estado real da máquina antes:

```bash
# versão atual do Plesk e build
plesk version

# distribuição e release
cat /etc/os-release

# espaço livre (o upgrade baixa pacotes e grava logs)
df -h /
df -h /tmp /var

# memória e swap disponíveis
free -m
```

Checklist de pré-voo, na ordem em que vale rodar:

- Distribuição e versão do SO estão na lista de suportados da versão de destino.
- Espaço em disco sobrando em `/`, `/var` e `/tmp`. Disco cheio interrompe o upgrade e aparece no log de instalação como `No space left on device`.
- Backup ou snapshot concluído **e verificado** (próxima seção).
- Nenhuma outra operação pesada agendada para a janela: cron de backup, importação de banco, crawl de SEO.
- Acesso SSH funcionando com usuário que não dependa do painel, porque o painel vai estar fora.
- Janela fora do horário comercial dos clientes do servidor. Em servidor de agência, isso costuma ser madrugada ou domingo de manhã.

## Snapshot ou backup do Plesk: qual dos dois permite reverter

Backup do Plesk e snapshot de máquina resolvem problemas diferentes. O backup do Plesk (assinaturas, bases, e-mail, configurações) devolve **conteúdo**. O snapshot de disco/VM devolve **o estado do servidor inteiro**, incluindo a versão do painel. Para reverter um upgrade que deu errado, é o snapshot que salva.

Se o ambiente é VPS ou dedicado com virtualização, tire o snapshot imediatamente antes de disparar o autoinstaller, com a janela já começada. Se não há snapshot disponível, aceite que a reversão será parcial e planeje a janela com mais folga: o caminho vira reinstalar/retomar e restaurar backup, que leva bem mais tempo.

Antes de prosseguir, valide que o backup existe de verdade: confira tamanho do arquivo e data, e, em pelo menos uma assinatura, abra o conteúdo do backup. Backup não verificado é esperança, não plano de reversão.

## Rodar o autoinstaller em sessão persistente e ler o log em paralelo

O upgrade do Plesk é feito pelo autoinstaller. Rode sempre dentro de uma sessão persistente, porque uma queda de SSH no meio da instalação é exatamente o cenário que você está tentando evitar:

```bash
# sessão persistente: se o SSH cair, o processo continua
screen -S plesk-upgrade
# ou: tmux new -s plesk-upgrade

# inicia o instalador/atualizador interativo
plesk installer
```

Enquanto o processo roda, abra um segundo terminal e acompanhe o log de instalação do autoinstaller em `/var/log/plesk/install/`. É nele que aparece o pacote exato que falhou, o que a mensagem genérica da tela não diz:

```bash
# lista os logs mais recentes
ls -lt /var/log/plesk/install/ | head

# acompanha o mais recente em tempo real
tail -f /var/log/plesk/install/autoinstaller3.log
```

O que observar no log, em vez de ficar olhando a barra de progresso:

- Falha de download de repositório: problema de rede ou mirror, costuma resolver retomando.
- `No space left on device`: pare, libere espaço, retome.
- Erro de dependência de pacote do SO: normalmente é o sinal de que o pré-check de distribuição foi ignorado.
- Falha na migração do banco do painel: é o caso em que reverter por snapshot costuma ser mais rápido que insistir.

Não feche a sessão achando que travou porque a tela ficou parada. Confirme pelo log antes de interromper qualquer coisa.

## Validação pós-upgrade em três a cinco assinaturas representativas

Terminar o upgrade não é terminar a janela. Escolha de três a cinco assinaturas representativas (uma WordPress com e-mail, uma estática, uma com banco pesado, uma com PHP mais antigo) e passe por todas as verificações. Não valide só o site que você lembra de cabeça.

| Verificação | Como testar | Resultado esperado |
|---|---|---||
| Painel | Acessar `https://servidor:8443` e logar | Login normal, versão nova exibida |
| Site HTTP/HTTPS | Abrir home e uma página interna | 200, sem erro de PHP, certificado válido |
| PHP por assinatura | Conferir versão de PHP nas configurações do domínio | Mesma versão de antes do upgrade |
| Banco | Abrir uma página que consulta o banco; abrir phpMyAdmin | Sem erro de conexão |
| Webmail | Logar em uma conta real | Caixa carrega, mensagens listadas |
| SMTP autenticado | Enviar uma mensagem por cliente externo autenticando na porta de submissão | Mensagem entregue |
| Recebimento | Enviar de fora para a conta de teste | Mensagem chega sem atraso |
| Agendamentos | Conferir tarefas cron/agendadas do painel | Lista intacta |

Um par de comandos resolve a checagem rápida de serviços antes de abrir o navegador:

```bash
# versão após o upgrade
plesk version

# estado dos serviços gerenciados pelo Plesk
systemctl status sw-cp-server --no-pager
systemctl status postfix dovecot --no-pager
```

Registre o resultado numa planilha simples com uma linha por assinatura testada. Em servidor de agência com muitos sites, essa planilha é o que você mostra ao cliente que reclama no dia seguinte: a assinatura dele foi verificada, está anotado o horário.

## Quando o upgrade para no meio: retomar, reparar ou reverter

Três caminhos, nessa ordem de preferência.

**Retomar o autoinstaller.** Para falha de rede, repositório indisponível ou disco cheio já corrigido, rodar `plesk installer` de novo retoma de onde parou. É o caminho menos destrutivo e costuma dar conta desse tipo de falha. Corrija a causa apontada no log antes de retomar; repetir o comando sem mexer em nada só repete o erro.

**Reparar o Plesk.** Se o painel sobe mas se comporta de forma estranha (componentes fora de sincronia, serviço que não inicia), use as ferramentas de reparo do Plesk antes de pensar em restaurar. O utilitário de linha de comando `plesk repair` cobre os casos típicos: `plesk repair installation` reconcilia a instalação do painel, `plesk repair web` as configurações de web server dos domínios e `plesk repair mail` as de e-mail. Rode primeiro em modo de verificação, sem aplicar nada, leia o relatório e só então autorize a correção. Depois, valide pelo que o reparo deveria ter arrumado: painel abrindo em 8443, site da assinatura afetada respondendo 200 e serviço que estava parado ativo no `systemctl status`.

**Reverter pelo snapshot.** Reserve para falha estrutural: migração do banco do painel interrompida, sistema de pacotes quebrado, servidor sem SSH. Restaurar o snapshot devolve o servidor ao estado pré-janela, incluindo a versão antiga do painel. O custo é perder tudo que entrou depois do snapshot: e-mails recebidos, pedidos, comentários. Por isso a janela precisa ser curta e em horário de baixo movimento, e por isso vale avisar o cliente de e-commerce separadamente.

Se chegou na reversão, não tente de novo no mesmo dia. Leia o log inteiro, descubra a causa, resolva o pré-requisito (espaço, distribuição, pacote conflitante) e remarque. Upgrade tentado duas vezes na mesma madrugada, no cansaço, é como se perde dado.

## Repetir a mesma janela em vários servidores e parar de estimar no chute

Se você mantém mais de um servidor Plesk, transforme isso num procedimento fixo em vez de improvisar a cada versão:

- Um servidor de menor criticidade sobe primeiro, com uma semana de observação antes dos demais.
- Mesma janela semanal para todos (exemplo: domingo, 6h às 8h), comunicada uma vez no contrato de manutenção.
- Um modelo único de e-mail de aviso, com data e hora como únicas variáveis.
- A mesma planilha de validação, com as assinaturas de amostra já escolhidas por servidor.
- Snapshot obrigatório, sem exceção, mesmo em upgrade "pequeno".
- Um registro curto após cada janela: versão de origem, versão de destino, duração real, o que deu errado.

Esse último item é o que mais rende com o tempo. Depois de três ou quatro janelas registradas, você para de estimar duração no chute e passa a dizer ao cliente um intervalo baseado no seu próprio histórico, naquele servidor, com aquele perfil de sites. A documentação oficial do Plesk dá o procedimento; o tempo real de cada servidor só o seu registro dá.

