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

# Caminho ideal de início

> A sequência recomendada: baixar, validar, instalar ferramentas e configurar backup antes do primeiro uso.

# Caminho ideal de início

Este é o caminho recomendado para uma instalação limpa. A ideia é evitar que o usuário comece a produzir sem saber se a máquina está saudável ou sem backup do hub.

<Steps>
  <Step title="Baixar e ativar">
    Rode o instalador privado com a key recebida.

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

    Esse comando ativa a licença, baixa o pacote privado e instala o COIA localmente.
  </Step>

  <Step title="Validar a instalação">
    Confira se a instalação ficou saudável.

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

    O doctor verifica estrutura, licença, help, porta, plugins e dependências. O status mostra principalmente a situação do backup.
  </Step>

  <Step title="Instalar ferramentas necessárias">
    Abra o setup guiado.

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

    O setup verifica Git, GitHub CLI, Git LFS, uv, Node/npm e ffmpeg. Se algo estiver ausente, aceite a instalação automática quando fizer sentido.
  </Step>

  <Step title="Configurar o backup GitHub">
    Se você não tem conta no GitHub, crie uma em [github.com](https://github.com). Depois faça login pelo terminal quando o setup pedir.

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

    Use um repositório privado, como `zoryon-coia-backup`, para proteger o hub do cliente.
  </Step>

  <Step title="Puxar antes de trabalhar">
    Antes de começar uma sessão, traga a versão mais recente do backup.

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

  <Step title="Enviar ao terminar">
    Ao fechar a sessão, envie o que mudou.

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

<CardGroup cols={2}>
  <Card title="Comandos de terminal" icon="terminal" href="/operar/comandos-terminal">
    Lista prática dos comandos para instalar, atualizar, diagnosticar e operar.
  </Card>

  <Card title="Backup GitHub" icon="github" href="/operar/backup-github">
    Passo a passo para criar conta, autenticar, conectar repositório privado e usar pull/push.
  </Card>
</CardGroup>

<Warning>
  Backup não deve enviar `.env.local`, cache de licença, keys, tokens ou segredos. O objetivo é proteger o trabalho, não expor credenciais.
</Warning>