> ## Documentation Index
> Fetch the complete documentation index at: https://zos-help.zoryon.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Atualizar o COIA

> Como atualizar o pacote preservando o hub do cliente.

# Atualizar o COIA

Atualizar troca o pacote do produto, mas deve preservar o hub do cliente. Antes de atualizar, traga o backup mais recente. Depois, valide a instalação.

<Steps>
  <Step title="Puxe o backup antes">
    Se o backup já estiver configurado, comece trazendo a versão mais recente.

    ```bash theme={null}
    zoryon-pull
    ```
  </Step>

  <Step title="Atualize o pacote">
    Rode o instalador em modo update.

    ```bash theme={null}
    curl -fsSL https://z-os.zoryon.co/install.sh | bash -s -- --update
    ```

    O update usa a licença já gravada, baixa a versão mais recente e preserva o hub.
  </Step>

  <Step title="Valide depois">
    Confirme se o COIA continua saudável.

    ```bash theme={null}
    zoryon --doctor
    zoryon status
    ```
  </Step>

  <Step title="Envie o estado final">
    Se houve mudança no hub, envie ao backup privado.

    ```bash theme={null}
    zoryon-push
    ```
  </Step>
</Steps>

## O que deve ser preservado

* Clientes.
* Perfil e voz.
* Wiki.
* Peças produzidas.
* Estados em andamento.
* `.env.local` e dados locais sensíveis.

<Warning>
  Atualização não deve apagar hub, wiki, clientes, estados ou segredos locais. Se algo parecer estranho, rode `zoryon --doctor` antes de produzir.
</Warning>

<CardGroup cols={2}>
  <Card title="Comandos de terminal" icon="terminal" href="/operar/comandos-terminal">
    Veja os comandos de instalação, atualização, diagnóstico e backup.
  </Card>

  <Card title="Backup GitHub" icon="github" href="/operar/backup-github">
    Configure o repositório privado e entenda pull/push.
  </Card>
</CardGroup>