# Instalar OpenArch CLI no Linux e Windows

Homebrew, Scoop, releases, workspace Compose, diagnóstico e migração de configuração.

Editora: Arquindex. Revisão: 06/11/2026.

URL canônica: https://www.arquindex.com.br/open-source-documental/openarch/instalacao-cli/

Escopo: Laboratório com Docker/Compose. Não foi iniciado um servidor OpenArch nesta revisão.

## Resposta direta

Instale o CLI pelo pacote da arquitetura ou gerenciador documentado, confira a versão e execute doctor, init e up em um laboratório Docker. A versão do CLI é independente da imagem do servidor.

## 1. Selecionar o CLI para o sistema operacional

A release consultada do CLI é 0.4.2. Use os assets de Linux, Windows ou macOS que correspondem à arquitetura da máquina. Confira checksum e instruções de assinatura publicadas com a release.

[Baixar OpenArch CLI 0.4.2](https://github.com/AlfrescoLabs/openarch-cli/releases/tag/v0.4.2) · [Código e instalação](https://github.com/AlfrescoLabs/openarch-cli)



```text
brew install AlfrescoLabs/tap/openarch
openarch version
```




```text
scoop bucket add alfrescolabs https://github.com/AlfrescoLabs/scoop-bucket
scoop install openarch
openarch version
```


Os gerenciadores precisam estar instalados previamente. As versões oferecidas pelo canal podem mudar; registre a saída de version. O binário do CLI sozinho não contém o servidor: ele prepara e inicia serviços Docker.

## 2. Conferir o host e criar o workspace



```text
openarch doctor
openarch init --dir openarch-lab
openarch up --dir openarch-lab
openarch status --dir openarch-lab
```


doctor verifica os pré-requisitos. init prepara os arquivos de composição; up inicia os serviços. O workspace contém configuração e segredos: não publique esses arquivos indiscriminadamente.

## 3. Confirmar o contrato da versão



```text
openarch help --output json
openarch smoke-test --help
```


O smoke test cria e remove conteúdo sintético. Execute-o somente no laboratório após revisar sua sintaxe e destino. Depois valide autenticação, criação, leitura, pesquisa e persistência após reinício.

## 4. Atualizar workspaces antigos

A família 0.4 introduz schemaVersion 2. Faça backup e reveja a migração em todos os computadores que usam o workspace; CLIs até 0.3.1 não leem o formato novo.



```text
openarch migrate --help
openarch migrate --dry-run
```


## Resultado esperado e limites

O status deve indicar ambiente saudável. Confirme a versão do servidor separadamente da versão do CLI. Upload de arquivo não comprova OCR, extração de texto ou integração com Alfresco. Teste conectores e restrições de acesso antes de usar dados de clientes.

## Fontes

[Release CLI 0.4.2](https://github.com/AlfrescoLabs/openarch-cli/releases/tag/v0.4.2) · [Descrição das mudanças 0.3/0.4](https://community.hyland.com/discussion/501595/openarch-0-3-and-0-4-json-help-an-mcp-server-and-an-agent-skill) · [Manual e código do CLI](https://github.com/AlfrescoLabs/openarch-cli)