# 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](/mnt/c/Users/Syllas/Documents/V-Fire-Monitor/installer/install_debian13.sh)
- [installer/vfire-stack.env.example](/mnt/c/Users/Syllas/Documents/V-Fire-Monitor/installer/vfire-stack.env.example)

## Passo 1: preparar configuracao

Copie o arquivo de exemplo:

```bash
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:

```env
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:

```bash
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`:

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

## Passo 4: validar os servicos

Verifique:

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

Healthchecks HTTP:

```bash
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:

```text
http://SEU_HOST:8088
```

Zabbix:

```text
http://SEU_HOST:8080
```

Grafana:

```text
http://SEU_HOST:3000
```

## Credenciais

O instalador grava um resumo em:

```text
/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:

```bash
systemctl restart vfire-monitor
```

Ver log do app:

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

Reiniciar Zabbix:

```bash
systemctl restart zabbix-server nginx
```

Reiniciar Grafana:

```bash
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