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

> Passo a passo para proteger o hub do cliente em um repositório privado do GitHub.

# Backup GitHub

Este processo protege o hub do cliente em um repositório privado do GitHub. Ele não publica o produto e não envia `.env.local`, licença local, caches ou arquivos sensíveis.

<Info>
  O backup guarda dados operacionais, wiki, states e peças produzidas. Ele existe para você conseguir retomar trabalho, trocar de máquina com menos risco e não perder histórico.
</Info>

## 1. Criar conta no GitHub

Se você ainda não tem conta, crie em [github.com](https://github.com). Use um e-mail que você consiga acessar e ative autenticação de dois fatores se o GitHub pedir.

Depois volte para o terminal.

## 2. Rodar o setup guiado

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

O primeiro bloco do setup verifica as ferramentas necessárias.

| Ferramenta        | Para que serve                                     |
| ----------------- | -------------------------------------------------- |
| Git               | Versionamento local do hub.                        |
| GitHub CLI (`gh`) | Login e criação do repositório privado.            |
| Git LFS           | Arquivos grandes, imagens e vídeos quando ativado. |
| uv                | Ambiente Python do motor.                          |
| Node.js/npm       | Setup interativo e interface `@clack/prompts`.     |
| ffmpeg            | Mídia, áudio e vídeo.                              |

Se algo estiver ausente, aceite a instalação automática. Se ela falhar, siga a orientação exibida no próprio setup e rode `zoryon-setup` novamente.

## 3. Fazer login no GitHub

Quando o setup pedir:

```bash theme={null}
gh auth login --web
```

Escolha GitHub.com, navegador/web e conclua a autenticação. Depois volte ao terminal. O setup valida `gh auth status` antes de criar o backup.

## 4. Escolher o repositório

Use o nome sugerido:

```text theme={null}
zoryon-coia-backup
```

O repositório é privado. Se ele já existir, o Zoryon conecta e faz pull sem apagar o trabalho local.

## 5. Decidir sobre Git LFS

Ative Git LFS se o cliente for guardar muita mídia no hub, como vídeos, imagens finais, áudios e materiais pesados. Para operações leves, pode deixar desativado e ativar depois.

## 6. Usar no dia a dia

```bash theme={null}
zoryon-status
zoryon-pull
zoryon-push
zoryon-sync
```

<CardGroup cols={2}>
  <Card title="Antes de trabalhar" icon="cloud-download">
    Use `zoryon-pull` para puxar a versão mais recente da nuvem.
  </Card>

  <Card title="Ao terminar" icon="cloud-upload">
    Use `zoryon-push` para enviar o que mudou.
  </Card>

  <Card title="Ver status" icon="activity">
    Use `zoryon-status` para confirmar se o backup está conectado.
  </Card>

  <Card title="Sincronizar" icon="refresh-cw">
    Use `zoryon-sync` quando quiser pull e push em um único comando.
  </Card>
</CardGroup>

## 7. Saúde do backup

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

Se o backup não estiver configurado, o status mostra `nao_configurado`. Isso não bloqueia o produto, mas significa que o hub está apenas local.

<Warning>
  Nunca envie `.env.local`, cache de licença, keys, tokens ou segredos para o repositório. O backup deve proteger o trabalho sem expor credenciais.
</Warning>