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

# Instalação

> Como instalar o COIA pelo instalador privado e o que fazer se o host exigir configuração manual.

# Instalação

O caminho principal é o instalador privado com key.

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

O instalador ativa a máquina, baixa o pacote privado e registra os plugins locais quando o host permite.

## Depois de instalar

<Steps>
  <Step title="Validar">
    ```bash theme={null}
    zoryon --doctor
    zoryon status
    ```
  </Step>

  <Step title="Abrir setup guiado">
    ```bash theme={null}
    zoryon-setup
    ```

    O setup verifica ferramentas, configura backup primeiro, trata APIs opcionais depois e roda doctor no fim.
  </Step>

  <Step title="Configurar backup GitHub">
    Se você ainda não tem conta no GitHub, crie em [github.com](https://github.com). Depois siga o login web pelo terminal.

    ```bash theme={null}
    gh auth login --web
    ```
  </Step>
</Steps>

## O que é instalado

O pacote privado contém o marketplace local `zoryon-coia` e os plugins:

* `zr-coia-hub`
* `zr-coia-marketing`
* `zr-coia-vendas`
* `zr-coia-operacoes`

## Se o registro automático não funcionar

Use o fallback do seu host.

### Claude Code

```text theme={null}
/plugin marketplace add <pasta-instalada>
/plugin install zr-coia-hub@zoryon-coia-local
```

### Codex

```bash theme={null}
codex plugin marketplace add <pasta-instalada>
codex plugin add zr-coia-hub@zoryon-coia
```

### Cursor

Abra a pasta instalada no Cursor. O pacote inclui regras, comandos e manifests para orientar o agente.

## Atualizar

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

A atualização preserva o hub do cliente.

<CardGroup cols={2}>
  <Card title="Comandos de terminal" icon="terminal" href="/operar/comandos-terminal">
    Referência dos comandos de instalação, doctor, setup, pull e push.
  </Card>

  <Card title="Backup GitHub" icon="github" href="/operar/backup-github">
    Passo a passo para proteger o hub em repositório privado.
  </Card>
</CardGroup>