V-Fire-Monitor/docs/INSTALACAO_DEBIAN13.md

Instalacao no Debian 13

Este guia cobre a instalacao da stack completa em uma maquina dedicada com:

• V-Fire Monitor
• PostgreSQL
• Zabbix Server + frontend
• Grafana

Visao geral

O instalador provisiona:

• app em /opt/vfire-monitor
• dados persistentes em /var/lib/vfire-monitor
• logs do app em /var/log/vfire-monitor/app.log
• servico systemd do V-Fire Monitor
• template do Zabbix importado automaticamente
• host monitorado do Zabbix criado automaticamente
• datasource do Grafana apontando para o Zabbix
• dashboard inicial do Grafana provisionado

Portas padrao:

• V-Fire Monitor: 8088
• Zabbix frontend: 8080
• Grafana: 3000

Requisitos

• Debian 13 (trixie)
• acesso root
• internet para baixar pacotes
• portas livres para os servicos
• chave VFM_LICENSE_MASTER_KEY se a instalacao for de producao

Arquivos do instalador

• installer/install_debian13.sh
• installer/vfire-stack.env.example

Passo 1: preparar configuracao

Copie o arquivo de exemplo:

cp installer/vfire-stack.env.example installer/vfire-stack.env

Edite installer/vfire-stack.env.

Observacoes importantes:

• ZABBIX_ADMIN_PASSWORD deve respeitar a politica da interface do Zabbix. Evite senhas contendo zabbix, admin ou administrator.
• Se quiser instalar em modo laboratorio usando a chave legada embutida, ajuste ALLOW_LEGACY_LICENSE_KEY=1. Nesse caso o instalador publica VFM_ALLOW_LEGACY_LICENSE_KEY=1 no servico do app.

Campos minimos que voce deve revisar:

• PUBLIC_HOSTNAME
• VFM_DEFAULT_PASSWORD
• VFM_LICENSE_MASTER_KEY
• ZABBIX_DB_PASSWORD
• ZABBIX_ADMIN_PASSWORD
• GRAFANA_ADMIN_PASSWORD

Se voce quiser testar sem chave mestre, pode usar:

ALLOW_LEGACY_LICENSE_KEY=1

Isso e aceitavel para laboratorio. Para producao, use VFM_LICENSE_MASTER_KEY.

Passo 2: validar em dry-run

Antes de instalar de verdade:

chmod +x installer/install_debian13.sh
./installer/install_debian13.sh --dry-run ./installer/vfire-stack.env

Esse modo mostra as principais acoes sem executar a instalacao real.

Passo 3: executar a instalacao

Como root:

./installer/install_debian13.sh ./installer/vfire-stack.env

Passo 4: validar os servicos

Verifique:

systemctl status vfire-monitor
systemctl status zabbix-server
systemctl status grafana-server
systemctl status nginx

Healthchecks HTTP:

curl http://127.0.0.1:8088/healthz
curl -I http://127.0.0.1:8080/
curl -I http://127.0.0.1:3000/login

Passo 5: acessar os paineis

Substitua SEU_HOST pelo hostname ou IP do servidor.

V-Fire Monitor:

http://SEU_HOST:8088

Zabbix:

http://SEU_HOST:8080

Grafana:

http://SEU_HOST:3000

Credenciais

O instalador grava um resumo em:

/root/vfire-stack-summary.txt

Esse arquivo inclui:

• URL do V-Fire Monitor
• senha inicial do painel
• senha do Admin do Zabbix
• senha do admin do Grafana
• credenciais do banco do Zabbix
• nome do template do Zabbix
• nome do host do Zabbix

Estrutura final

Arquivos principais apos instalar:

• codigo: /opt/vfire-monitor
• dados: /var/lib/vfire-monitor
• ambiente: /etc/default/vfire-monitor
• servico: /etc/systemd/system/vfire-monitor.service

Operacoes comuns

Reiniciar o app:

systemctl restart vfire-monitor

Ver log do app:

tail -f /var/log/vfire-monitor/app.log

Reiniciar Zabbix:

systemctl restart zabbix-server nginx

Reiniciar Grafana:

systemctl restart grafana-server

Observacoes

• o instalador foi desenhado para Debian 13
• o app roda com Waitress, nao com o servidor de desenvolvimento do Flask
• o frontend do app usa assets locais, sem depender de CDN