Pular para o conteúdo
Documentação

Atualizar o painel e voltar de versão

Como atualizar o miniCP pela aba Atualizacao, ler o changelog e voltar para uma versão anterior.

R Regis Manze 20/11/2026 5 min de leitura

A aba Atualização instala novas versões do miniCP e permite voltar para uma versão anterior, sem usar o terminal. Acesse em Configuracoes → Atualizacao.

O que a tela mostra

Item Significado
Versao em uso Versão do painel rodando agora
Mais recente Última versão publicada pela equipe miniDC. Aparece o selo nova quando é mais nova que a em uso
Versao para instalar Lista de versões que você pode instalar neste servidor
Changelog O que muda entre a versão em uso e a escolhida

A verificação roda sozinha ao abrir a aba. Para consultar de novo, clique em Verificar agora.

Quais versões aparecem na lista

  • A mais recente publicada.
  • A em uso.
  • As versões guardadas neste servidor: as que já foram baixadas e as que estavam em uso antes de cada atualização.

O servidor guarda até 8 pacotes de versões. Uma versão que não está guardada aparece desabilitada: não é possível baixar versões antigas que nunca passaram por este servidor.

Atualizar para a versão mais recente

  1. Abra Configuracoes → Atualizacao.
  2. Confira a mensagem Atualizacao disponivel.
  3. Em Versao para instalar, deixe selecionada a mais recente (já vem selecionada quando há atualização).
  4. Leia o bloco O que muda. Cada versão nova aparece com o selo novo.
  5. Clique em Atualizar para vX.Y.Z e confirme.
  6. Acompanhe o Progresso. Ao final, aparece Painel reiniciando... e a página recarrega sozinha.

O que acontece durante a atualização

  1. O pacote da versão escolhida é baixado (ou lido do servidor, se já estiver guardado).
  2. A versão em uso é guardada, para permitir voltar a ela depois.
  3. O pacote é extraído e o código é verificado. Se tiver erro, nada é aplicado.
  4. Os arquivos novos são aplicados por cima dos atuais.
  5. O painel reinicia em cerca de 3 segundos.

São preservados: os dados e configurações do painel, arquivos .env, chaves e certificados.

Atenção: o painel fica fora do ar por alguns segundos durante o reinício. Os sites continuam no ar: a atualização mexe só no painel, não no Apache, NGINX ou PHP.

Migração dos logs das contas (versão 2.66.0)

Ao subir para a 2.66.0 ou posterior, o painel faz, uma única vez por servidor, a migração dos logs das contas: move os logs existentes de /home/<usuario>/logs para /var/log/minicp/users/<usuario>/, cria os atalhos em ~/logs, regrava vhosts, pools PHP-FPM, serviços e o logrotate e recarrega o servidor web. A migração fica registrada na Auditoria com a ação user_logs_v2. Os clientes continuam lendo os logs pelo mesmo caminho de antes.

Voltar para uma versão anterior

  1. Em Versao para instalar, escolha uma versão mais antiga, marcada como guardada.
  2. O título do changelog muda para Sera desfeito ao voltar para vX.Y.Z e lista, com o selo sera desfeita, tudo o que deixa de existir.
  3. O botão muda para Voltar para vX.Y.Z (em amarelo). Clique e confirme.

Atenção: ao voltar, os recursos adicionados nas versões posteriores somem. Dados salvos por versões mais novas podem ser ignorados pela versão antiga.

Se escolher a própria versão em uso, o botão vira Reinstalar vX.Y.Z. Use para restaurar arquivos do painel alterados por engano.

Changelog

O changelog é exibido conforme a versão escolhida:

Escolha O que aparece
Versão mais nova O que muda da versão em uso até a escolhida
Versão mais antiga O que será desfeito
Versão em uso As notas só dessa versão
mostrar todas as versoes marcado O changelog completo

Cada entrada traz o número da versão, o tipo (major, minor ou patch), a data, o título e as notas. A versão em uso tem o selo em uso.

Dica: versões anteriores à 2.51.0 não trazem changelog no pacote.

Erros comuns

Mensagem O que fazer
Nao foi possivel verificar O servidor não conseguiu consultar as atualizações. Confira o acesso à internet e se o IP do servidor está liberado com a equipe miniDC.
HTTP 403 ou 401 ao baixar o pacote O IP do servidor não está autorizado. Fale com a equipe miniDC.
Versão não guardada O servidor só baixa a versão mais recente. Versões antigas só podem ser instaladas se já estiverem guardadas.
Pacote com erro, não aplicado O pacote não passou na verificação. Nada foi alterado. Tente de novo mais tarde ou fale com a equipe miniDC.

Atualização manual

Se o painel não abrir, a equipe miniDC pode fornecer o pacote para aplicar no terminal. Depois de qualquer troca manual de arquivos, reinicie o serviço do painel:

systemctl restart mageweb

Dica: ative Configuracoes → Alertas para receber aviso quando houver atualização disponível.

Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!