---
url: https://developers.zarv.com/edge-agent.md
---
# Zarv Agent

O **Zarv Agent** (`zarv-agent`) é um agente on-premise que roda na rede do
cliente. Ele ingere streams de câmeras (RTSP/ONVIF), executa a visão
computacional localmente (veículo, pessoa, placa, face) e envia à Zarv apenas
os eventos relevantes e a mídia associada — o vídeo bruto nunca sai do
perímetro.

É distribuído como um pacote **autocontido**: ffmpeg, o runtime de inferência e
os modelos já vêm embutidos. Não há dependências externas para resolver além da
`glibc` — você instala e o serviço sobe sozinho.

## Como funciona

```
Câmeras (RTSP/ONVIF)  →  Zarv Agent (inferência local)  →  Zarv (eventos + mídia)
                              ↑
                    Zarv (registro, configuração, OTA)
```

* **Plano de dados:** o agente decodifica cada stream, roda os modelos ONNX e
  emite eventos. Só o que é relevante sobe para a nuvem.
* **Plano de controle:** o registro, a configuração por dispositivo, os
  heartbeats e as atualizações são orquestrados pela Zarv. Depois de
  registrado, o agente se mantém atualizado por OTA — zero manutenção do seu
  lado.

## Sistemas operacionais suportados

| Plataforma                  | Método                  | Arquiteturas        |
| --------------------------- | ----------------------- | ------------------- |
| Debian 11+ / Ubuntu 20.04+  | APT (nativo)            | `amd64`, `arm64`    |
| RHEL 9+ / Fedora / openSUSE | RPM (nativo)            | `x86_64`, `aarch64` |
| Outros Linux / macOS        | Docker                  | `amd64`, `arm64`    |
| Windows                     | Docker (via PowerShell) | `amd64`             |

Os pacotes nativos (APT/RPM) são a forma recomendada: instalam o serviço
`zarv-agent` com **auto-start no boot** via systemd e se atualizam pelo próprio
repositório, sob controle da Zarv.

## Requisitos

* **Acesso de saída HTTPS** (porta 443) para `collector.zarv.com` — registro,
  configuração, heartbeat, atualizações (OTA) e upload de eventos/telemetria.
* **Acesso de rede às câmeras** (RTSP/ONVIF) dentro do perímetro.
* **Porta `8088` local** para a interface de gerenciamento (usada apenas no
  primeiro registro; não precisa estar exposta na rede).
* Privilégio de `root`/`sudo` para a instalação nativa (registra o serviço
  systemd `zarv-agent`).

## Próximos passos

* [Instalação](/edge-agent/installation) — instale em Debian/Ubuntu,
  RHEL/Fedora, Docker ou Windows.
* [Registro](/edge-agent/enrollment) — registre o dispositivo com a chave de
  enrollment da Zarv.
* [Atualizações automáticas](/edge-agent/updates) — como o OTA funciona e como
  configurar uma janela de manutenção (ex.: só às 03:00).
* [Configuração](/edge-agent/configuration) — variáveis de ambiente locais.
* [Solução de problemas](/edge-agent/troubleshooting) — diagnóstico de serviço,
  rede, câmeras e armazenamento.