---
url: https://developers.zarv.com/edge-agent/configuration.md
---
# Configuração

A maior parte da configuração operacional do agente (câmeras, tuning de
inferência, política de atualização) é gerenciada **centralmente pela Zarv** —
você não precisa mexer no dispositivo. O arquivo local serve apenas para
parâmetros de infraestrutura e para apontar/provisionar o agente.

## Onde fica

Variáveis de ambiente do serviço ficam em **`/etc/default/zarv-agent`** (um
conffile: suas edições sobrevivem a upgrades). O agente também lê
`<DataDir>/config.env`, escrito pela própria interface de Configurações; valores
ali têm precedência sobre o arquivo de defaults.

Após editar, reinicie o serviço:

```sh
sudo systemctl restart zarv-agent
```

## Destino do tráfego

Toda a saída do agente — registro, configuração, heartbeat, eventos, telemetria
e atualizações (OTA) — vai para um **único host**:

`collector.zarv.com`.

| Variável           | Padrão  | Descrição                                           |
| ------------------ | ------- | --------------------------------------------------- |
| `EDGE_AGENT_DEBUG` | `false` | Uso interno da Zarv. Mantenha `false` (ou ausente). |

::: tip
Não é preciso configurar URLs de upstream manualmente: o agente já envia tudo
para `collector.zarv.com`.
:::

## Variáveis de infraestrutura

| Variável                                | Padrão                | Descrição                                                                                   |
| --------------------------------------- | --------------------- | ------------------------------------------------------------------------------------------- |
| `EDGE_AGENT_DATA_DIR`                   | `/var/lib/zarv-agent` | Diretório de estado: banco SQLite, blobs, `config.env`.                                     |
| `EDGE_AGENT_HTTP_LISTEN`                | `0.0.0.0:8088`        | Endereço da interface local de gerenciamento. Use `127.0.0.1:8088` para restringir ao host. |
| `EDGE_AGENT_MODELS_DIR`                 | `/opt/zarv/models`    | Diretório dos modelos ONNX (embutidos no pacote).                                           |
| `EDGE_AGENT_LOG_LEVEL`                  | `info`                | Nível de log: `debug`, `info`, `warn`, `error`.                                             |
| `EDGE_AGENT_LOG_FORMAT`                 | `json`                | Formato de log: `json` ou `text`.                                                           |
| `EDGE_AGENT_HEARTBEAT_INTERVAL_SECONDS` | `60`                  | Cadência do heartbeat para a Zarv.                                                          |

## Provisionamento e atualização

| Variável                      | Exemplo             | Descrição                                                                                                                                |
| ----------------------------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `EDGE_AGENT_ENROLLMENT_TOKEN` | *(chave)*           | Chave de enrollment para registro automático no primeiro boot. Consumida e removida em seguida. Veja [Registro](/edge-agent/enrollment). |
| `EDGE_AGENT_UPDATE_WINDOW`    | `03:00-04:00`       | Janela de manutenção para aplicar atualizações. Veja [Atualizações](/edge-agent/updates).                                                |
| `EDGE_AGENT_UPDATE_TIMEZONE`  | `America/Sao_Paulo` | Fuso (IANA) da janela. Vazio = hora local do dispositivo.                                                                                |

::: warning
Parâmetros de inferência, tuning e throttling não devem ser definidos
localmente: eles são geridos pela Zarv para preservar qualidade de detecção e
volume de eventos. A interface local de Configurações expõe apenas os ajustes
de infraestrutura acima.
:::

## Exemplo de `/etc/default/zarv-agent`

```sh
# Estado persistente.
EDGE_AGENT_DATA_DIR=/var/lib/zarv-agent

# Interface de gerenciamento (restrita ao host).
EDGE_AGENT_HTTP_LISTEN=127.0.0.1:8088

# Janela de manutenção para atualizações (madrugada, horário de São Paulo).
EDGE_AGENT_UPDATE_WINDOW=03:00-04:00
EDGE_AGENT_UPDATE_TIMEZONE=America/Sao_Paulo
```