O que é
Em Configurações → Atualizações você mantém o painel atualizado. As atualizações trazem correções (inclusive de segurança) e novos recursos. É onde você verifica versões, escolhe o canal e aplica a atualização.
Verificando atualizações
Clique em Verificar atualizações. O painel mostra a versão atual, se há uma versão nova e uma descrição do que ela traz. Não há cronograma fixo de lançamentos.
Canal estável × canal beta
- Canal estável (padrão): versões testadas, recomendadas para produção.
- Canal beta: recursos ainda não amplamente testados, usados principalmente nos servidores de teste da GW.
Evite o canal beta em produção. Só use se precisa muito de um recurso específico e sabe trabalhar com snapshot para restaurar caso algo dê errado. Beta significa “ainda não testado em produção”.
Snapshot antes de atualizar (obrigatório)
Sempre faça um snapshot do servidor antes de atualizar. Atualizar é um processo de risco: a GW busca só lançar versões estáveis, mas há sempre uma margem imprevisível.
O snapshot é feito no seu provedor de cloud, não no painel:
- No provedor (DigitalOcean, Vultr, Linode, Hetzner…), encontre a opção de snapshot.
- Crie o snapshot do servidor e aguarde concluir.
Assim, se a atualização quebrar algo, você restaura o snapshot. (Na Oracle, o equivalente é backup do volume de inicialização.)
Duas formas, o mesmo instalador
Você pode atualizar pelo terminal (SSH) ou pelo botão do painel. Os dois executam o mesmo instalador e aplicam a mesma coisa: arquivos do painel, pacotes (Nginx e PHP), serviços e todas as correções pendentes do servidor.
- Pelo terminal (recomendado): você acompanha cada passo ao vivo e, se algo sair do esperado, já está dentro do servidor para agir. É também o caminho que funciona quando o painel não abre.
- Pelo painel: mais prático. O painel roda o instalador no servidor e mostra o andamento na tela.
A tela de Atualizações mostra os dois, com o comando certo para o seu canal.
Atualizando pelo painel
- Clique em Verificar atualizações.
- Marque a caixa confirmando que você entende os riscos e fez o snapshot.
- Clique em Atualizar para vX agora.
A atualização leva alguns minutos e o log aparece na tela. Você pode fechar a página: ela continua no servidor, e o andamento volta a aparecer quando você abrir a tela de Atualizações de novo. Ao concluir, o dashboard e a aba Sistema já mostram a nova versão.
Se algum passo não concluir, a tela avisa (“concluída com pendências”) e oferece Rodar de novo. Repetir é seguro: o que já foi aplicado é mantido e só o que ficou pendente é tentado outra vez.
Os sites continuam no ar. No fim da atualização o painel recarrega o PHP em vez de reiniciá-lo, o que troca o código sem derrubar as conexões em andamento. No máximo, uma visita que chegue exatamente nesse instante pode receber um erro e carregar normalmente ao tentar de novo.
Atualizando via SSH
É o caminho recomendado. Em casos raros (quando o próprio mecanismo de atualização muda), o painel pede que a atualização daquela versão seja feita só pelo terminal e mostra apenas o comando.
Conecte-se ao servidor por SSH como root e execute:
bash <(curl -sL https://cdn.g-web.link/gw-server/panel/panel-install.sh) --update
Ao terminar, recarregue a página do painel para confirmar a nova versão.
Se você usa o canal beta, o comando é outro — ele aponta para o instalador da sandbox:
bash <(curl -sL https://cdn.g-web.link/gw-server/sandbox/panel/panel-install.sh) --update
O painel já mostra o comando certo para o seu canal; use o botão de copiar e não erre.
Faça o snapshot antes, como na atualização pelo painel. O comando aplica a atualização completa e não pergunta de novo.
O comando sempre instala a última versão do seu canal e reaplica todas as proteções do servidor. Rodá-lo de novo na mesma versão é seguro: funciona como uma reinstalação.
Reinstalar a versão atual
Serve para uma segunda tentativa quando a atualização terminou com pendência, ou para refazer as configurações do servidor sem trocar de versão.
- Em Configurações → Atualizações, no cartão Reinstalar a versão atual, clique em Reinstalar vX.
- Marque a caixa confirmando que você fez o snapshot.
- Clique em Reinstalar vX agora.
O painel confere o canal antes: se houver uma versão mais nova publicada, ele oferece a atualização no lugar (ela já reinstala tudo). Se a versão do canal for mais antiga que a instalada (por exemplo, depois de sair do canal beta), a reinstalação não é oferecida, porque rebaixaria o painel.
Pelo terminal, reinstalar é rodar o mesmo comando da atualização.
Aviso de novas versões
Configure em Alertas o aviso por e-mail de novas versões (requer SMTP). Com o aviso ligado, o próprio servidor consulta o canal a cada 6 horas: não é preciso abrir esta tela nem clicar em Verificar atualizações para receber o aviso.
