# Atualizar com o updater – guia passo a passo

Com o updater rodando na instalação, você atualiza o draften na página Instalação com um botão. O aplicativo continua funcionando e, se a nova versão causar problemas, voltar é igualmente fácil.

**Antes de começar**

- **O operador da instalação** — Só o operador (superadmin na interface) vê a parte Instalação do menu.
- **Um updater rodando** — Ele é ativado na instalação (COMPOSE_PROFILES=updater no .env). Sem ele, você atualiza com ./draften update.

## Passo 1 de 8: Abra a página Instalação

Na tela: No menu, em Instalação, a página Instalação; no topo, o cartão Versão.

Faça isto: A linha **Em execução** mostra a versão que está funcionando agora. A linha **Updater** precisa dizer **em execução** – caso contrário, não dá para atualizar aqui e você usa a linha de comando.

> Observação: O updater procura novas versões sozinho, e a linha diz quando fez isso pela última vez. Ele as baixa com a chave da licença; numa máquina sem internet, ele oferece uma versão que você copia para a pasta `updates/` do diretório da instalação.

## Passo 2 de 8: Leia o que há de novo

Na tela: A parte Novas versões, com a versão oferecida.

Faça isto: A versão mostra a data de lançamento, o tamanho e as notas da versão. Leia-as para saber o que muda para as pessoas nas organizações.

> Observação: Uma versão que retiramos traz o rótulo **retirada** e o motivo; o updater não a oferece.

## Passo 3 de 8: Inicie a atualização

Na tela: Abaixo das notas, um botão com o número da nova versão.

Faça isto: Clique em **Atualizar para 2026.9.2**.

> Observação: O aplicativo continua funcionando durante a atualização: a nova versão sobe ao lado da atual e só assume quando está saudável. Antes disso, o updater faz um dump do banco de dados na pasta `backups/`.

## Passo 4 de 8: Confirme

Na tela: Uma caixa de diálogo perguntando se deve atualizar para a nova versão.

Faça isto: Clique em **Atualizar**.

## Passo 5 de 8: Acompanhe o progresso

Na tela: No cartão Versão, a solicitação Atualização para 2026.9.2 com o status em andamento.

Faça isto: Em **Progresso**, o updater vai acrescentando as linhas dele: verificação do pacote, dump do banco de dados, migração, início da nova versão. A página se atualiza sozinha a cada dois segundos.

> Observação: Enquanto a solicitação está **na fila**, você pode clicar em **Cancelar a solicitação**. Se a atualização falhar, a versão atual continua funcionando e o erro aparece em vermelho na solicitação.

## Passo 6 de 8: Carregue a nova versão

Na tela: Uma faixa verde A versão 2026.9.2 está em execução.

Faça isto: A nova versão assumiu. Mas a página no seu navegador ainda é da versão antiga – clique em **Carregar a nova versão**.

## Passo 7 de 8: Se a nova versão causar problemas

Na tela: Abaixo da versão, a oferta de voltar para a anterior.

Faça isto: Clique em **Voltar para 2026.9.1** e confirme. O updater volta para a versão que funcionava antes da atualização; enquanto isso, o aplicativo continua funcionando.

> Observação: Depois de uma atualização, a versão anterior continua rodando sem tráfego, então a volta é imediata. Voltar mais atrás significa restaurar um dump do banco de dados – a página Atualizar pela linha de comando explica como.

## Passo 8 de 8: O histórico de solicitações

Na tela: No fim da página, o cartão Solicitações.

Faça isto: Aqui estão as dez últimas solicitações ao updater – atualizações, voltas de versão, mudanças no número de processos e trocas de chave: quem pediu, quando terminaram e algum erro.

**A instalação está na nova versão** — Uma atualização não mexe nas configurações dos assistentes, nas instruções nem nos e-mails – tudo isso fica no banco de dados.

- **Sem updater?** — A página Atualizar pela linha de comando descreve o ./draften update, a verificação de um pacote e a volta para uma versão anterior.
- **Dumps do banco de dados** — Antes de cada atualização, o banco de dados é salvo em backups/ (os três últimos são mantidos). Copie-os, junto com o .env, para fora do servidor – veja Backup e restauração.