> ## 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.

# Backup do hub

> Como proteger os dados do cliente sem expor segredos.

# Backup do hub

O hub guarda a memória operacional do cliente: perfil, wiki, decisões, estados de trabalho e peças produzidas. Para uso real, o ideal é iniciar o backup logo no começo, antes da primeira rotina de produção.

<Info>
  O backup recomendado usa um repositório privado no GitHub. Ele protege o trabalho, mas não publica o produto e não envia segredos locais.
</Info>

## Regra simples

<Steps>
  <Step title="Puxe antes de trabalhar">
    Antes de iniciar uma sessão, traga a versão mais recente da nuvem.

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

  <Step title="Trabalhe normalmente">
    Use o COIA, produza peças, atualize wiki, registre decisões e avance os processos.
  </Step>

  <Step title="Envie ao terminar">
    Ao fechar a sessão, envie o que mudou para o backup privado.

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

Se quiser um comando único para puxar e enviar, use:

```bash theme={null}
zoryon-sync
```

## O que entra no backup

* Perfil do cliente.
* Voz, oferta, objeções e posicionamento.
* Wiki e registros de decisão.
* Estados das peças em andamento.
* Peças produzidas.
* Fila editorial.
* Dados operacionais e comerciais do cliente.

## O que não deve subir

* `.env.local`
* Cache de licença local.
* Keys.
* Tokens.
* Segredos.
* Arquivos temporários e caches.

<Warning>
  Backup bom preserva trabalho sem expor segredo. Se tiver dúvida se um arquivo contém senha, token ou key, não envie antes de revisar.
</Warning>

## Quando configurar

Configure logo depois de instalar e validar o COIA:

```bash theme={null}
zoryon --doctor
zoryon-setup
```

O setup guiado instala ou valida as ferramentas necessárias, ajuda no login do GitHub e cria/conecta o repositório privado.

<CardGroup cols={2}>
  <Card title="Backup GitHub passo a passo" icon="github" href="/operar/backup-github">
    Criar conta, autenticar, escolher repositório e usar pull/push.
  </Card>

  <Card title="Comandos de terminal" icon="terminal" href="/operar/comandos-terminal">
    Lista prática de comandos para instalar, validar, atualizar e operar.
  </Card>
</CardGroup>