Developers

Aparência

Instalação ​

A instalação é um único comando, em qualquer sistema operacional. O pacote é autocontido (ffmpeg, runtime de inferência e modelos já inclusos) e, nos métodos nativos, o serviço zarv-agent sobe sozinho no boot via systemd.

Escolha o método ​

sh
curl -fsSL https://collector.zarv.com/agent/install-apt.sh | sh
sh
curl -fsSL https://collector.zarv.com/agent/install-rpm.sh | sh
sh
curl -fsSL https://collector.zarv.com/agent/install.sh | sh
powershell
irm https://collector.zarv.com/agent/install.ps1 | iex
sh
docker compose up -d

Recomendação

Em Debian/Ubuntu e RHEL/Fedora, prefira os pacotes nativos (APT/RPM): eles registram o serviço zarv-agent com auto-start no boot e se atualizam pelo próprio repositório sob controle da Zarv. Use Docker apenas em sistemas sem pacote nativo.

O que o instalador faz ​

Tomando o APT como exemplo, o script:

  1. Adiciona o repositório de pacotes da Zarv e sua chave de assinatura.
  2. Instala o pacote zarv-agent (já inclui ffmpeg, runtime e modelos).
  3. Aponta o agente para o plano de controle da Zarv.
  4. Registra e inicia o serviço systemd zarv-agent, habilitado no boot.

O fluxo do RPM é equivalente.

Registro ​

Depois de instalar, registre o dispositivo:

  1. Abra a interface local em http://localhost:8088.
  2. Cole a chave de enrollment gerada no painel da Zarv.
  3. Pronto — a partir daí a Zarv controla atualizações e features por OTA.

Detalhes em Registro.

Verificação ​

Confirme que o serviço está rodando e habilitado no boot:

sh
systemctl is-enabled zarv-agent   # → enabled
systemctl is-active  zarv-agent   # → active
systemctl status     zarv-agent

Verifique a versão em execução nos logs:

sh
journalctl -u zarv-agent | grep "starting"

E que a interface local responde:

sh
curl -fsS -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8088/   # → 200

Layout no disco (instalação nativa) ​

CaminhoConteúdo
/usr/local/bin/zarv-agentBinário do agente.
/lib/systemd/system/zarv-agent.serviceUnit systemd (auto-start no boot).
/etc/default/zarv-agentVariáveis de ambiente do serviço (conffile).
/var/lib/zarv-agentEstado persistente: banco SQLite, blobs, config.env.
/opt/zarv/{bin,lib,models}ffmpeg, libs e modelos embutidos.

O serviço roda como o usuário de sistema sem privilégios zarv-agent.

Configuração local ​

Variáveis de ambiente ficam em /etc/default/zarv-agent. As mais comuns estão em Configuração. Após editar, reinicie:

sh
sudo systemctl restart zarv-agent

Desinstalação ​

sh
sudo apt-get remove --purge zarv-agent
sh
sudo dnf remove zarv-agent
sh
docker rm -f zarv-agent

Próximos passos ​