ImplantaçãoGuia

Atualize sua instalação

A maioria das versões não pede nada além de baixar as imagens novas. Quando alguma pede, a entrada dela na página de versões diz isso logo no topo, com a linha exata para colar. Os admins também veem um aviso pequeno no app quando sai uma versão nova.

4 min de leituraAntes: Self-host com Docker Compose
O que você vai aprender
  • Saber se uma versão pede algo de você
  • Atualizar com Docker Compose ou Helm
  • Desligar o aviso de versão nova

Antes de atualizar

Abra a página de versões e escolha a versão que você usa em Sua versão. Um quadro acima da lista junta todos os passos entre ela e a mais nova, na ordem de fazer. Se o quadro disser que não há nada a fazer, vá direto aos comandos abaixo.

A versão que está rodando aparece em Configurações → Faturamento, e em WAISO_VERSION se você fixou uma no .env.

waisoSaiu a 1.7.0 · um passo antes de atualizarLerA
1.7.01 de dezembro de 2026
Ação necessária antes de atualizarAntesColoque a nova configuração no .env.WAISO_EXAMPLE=on
Comandos de atualizaçãoComposeHelm
O aviso diz a versão mais nova e se ela pede algo; a entrada dela diz o quê, com a linha para colar.

As versões são numeradas como maior.menor.correção. Uma correção arruma a versão anterior. Uma versão menor traz coisas novas, e é onde um passo aparece com mais frequência. Uma versão maior mudaria a forma de rodar uma instalação, e viria com um guia próprio.

Atualizar não pula nada: ir da 1.4.0 para a 1.6.1 de uma vez funciona, desde que você faça os passos que o quadro lista para cada versão no meio. Não é preciso parar em cada versão pelo caminho.

Docker Compose

Defina a versão no .env (ou deixe WAISO_VERSION sem valor para seguir o arquivo compose que você tem), depois baixe e reinicie. A API aplica as próprias mudanças no banco quando inicia.

Shellterminal
# .env
WAISO_VERSION=1.6.1

docker compose pull && docker compose up -d --remove-orphans

--remove-orphans para serviços que uma versão nova não tem mais. Se uma versão mudou o próprio arquivo compose, a entrada dela diz para pegar o arquivo novo antes.

Kubernetes (Helm)

Shellterminal
helm upgrade waiso oci://ghcr.io/talissonjunior16/charts/waiso --version 1.6.1 --reuse-values

--reuse-values mantém suas configurações. Um passo que adiciona uma configuração diz o valor a colocar em api.env ou a chave onde ele entra.

Se algo parecer errado depois de atualizar

  • Confira se todos os serviços rodam a mesma versão: docker compose ps mostra as tags das imagens. Um worker que ficou na versão antiga pega execuções que a API nova já não espera.
  • Leia o log da API desde o início: docker compose logs api. As mudanças no banco são aplicadas ali, e um problema com uma delas aparece escrito em palavras simples.
  • Recarregue a aba do navegador, para ela carregar o app web novo em vez do que ficou aberto.

O aviso de versão nova

A cada 12 horas a API lê https://waiso.dev/changelog/latest.json, um arquivo público com a lista de versões. O pedido não leva nada sobre a sua instalação. Quando há uma versão mais nova, os admins veem um aviso pequeno na barra de cima, com link para a entrada dela; ninguém mais vê, e dá para esconder até a próxima versão.

  • Docker Compose: defina WAISO_UPDATE_CHECK=off no .env.
  • Helm: coloque WAISO_UPDATE_CHECK: "off" em api.env.

Assuntos relacionados