# Terminal

[English](../cli.md) · **Português**

O binário `acaua` atua tanto como utilitário de linha de comando quanto como daemon de segundo plano.
Esta página descreve os comandos disponíveis no motor.

```text
acaua <command> [options]

Comandos:
  serve    Inicia a API e o dashboard web embutido
  analyze  Analisa um diretório de logs do Zeek
  doctor   Verifica o ambiente local
  update   Checa por releases disponíveis
```

## `acaua serve`

Inicia a API HTTP e o dashboard web embutido.

```bash
acaua serve --bind 127.0.0.1:8787 --data-dir .acaua
```

| Opção | Padrão | Significado |
|---|---|---|
| `--bind` | `127.0.0.1:8787` | Endereço de escuta |
| `--data-dir` | `.acaua` | Diretório de dados e arquivos de execução |

O bind padrão restringe-se a loopback. Expô-lo em uma rede exige um proxy
reverso com autenticação. A API está documentada em
[arquitetura.md](arquitetura.md#api).

## `acaua analyze`

```bash
acaua analyze /var/log/zeek/current
acaua analyze /var/log/zeek/current --json
```

Valida o diretório alvo, ingere tráfego do `conn.log` em partições Parquet e
executa os algoritmos de detecção de ameaças.

## `acaua doctor`

```bash
acaua doctor
acaua doctor --json
```

Executa checagens de ambiente:
- `zeek`: verifica `zeek --version` ou detecta execução em container (`ACAUA_RUNTIME=container`).
- `curl`: confirma disponibilidade de download HTTP.
- `duckdb`: confirma linkagem dinâmica contra a `libduckdb.so` em tempo de execução.
- `research`: valida o isolamento do workspace de pesquisa.

## `acaua update`

```bash
acaua update
```

Consulta a API de Releases do Gitea, compara a última tag com a versão em
execução e imprime instruções de atualização (`docker compose pull && docker compose up -d`
quando em container).

## Códigos de saída

| Código | Significado |
|---|---|
| `0` | Sucesso |
| `1` | Erro em tempo de execução (caminho inválido, erro de consulta, I/O) |
| `2` | Uso inválido de linha de comando (clap) |

## Ambiente

| Variável | Significado |
|---|---|
| `ACAUA_RUNTIME` | Definida como `container` em imagens Docker para adaptar checagens |
| `DUCKDB_LIB_DIR` | Caminho do diretório contendo `libduckdb.so` em compilação nativa |
| `LD_LIBRARY_PATH` | Caminho de busca de bibliotecas compartilhadas para `libduckdb.so` |