Escolha como instalar o servidor
| Forma | Ideal para | Requisitos |
|---|---|---|
| 1. Imagem de VM pronta | Importar, iniciar, entrar — em poucos minutos | VMware, Proxmox/KVM ou Hyper-V; sem acesso à internet |
| 2. ISO do appliance | Uma VM nova ou um servidor físico, sem intervenção | Acesso à internet durante a instalação |
| 3. Script de instalação | Um servidor Debian, Ubuntu, AlmaLinux ou Rocky Linux existente | Root e acesso à internet |
| 4. Pacotes manualmente | Seu próprio PostgreSQL, gerenciamento de configuração, servidores off-line | O pacote deb ou rpm da versão |
O servidor precisa de 2 vCPU, 2 GB de RAM e um disco de 16 GB. Os navegadores acessam o console em TCP 8443; agentes e coletores remotos se conectam em TCP 8444.
1. Imagem de VM pronta
VMware ESXi, Workstation, VirtualBox
ESXi Host Client: Create / Register VM → Deploy a virtual machine from an OVF or OVA file. vCenter: Deploy OVF Template.
Proxmox VE e KVM
Crie uma VM sem disco (2 vCPU, 2 GB de RAM, rede VirtIO), importe o disco, conecte-o como disco de boot SCSI e ative o QEMU guest agent.
Hyper-V (geração 1)
Descompacte, crie uma VM de geração 1 com 2 GB de RAM e escolha o VHDX como disco.
No Proxmox VE, depois de copiar a imagem para o nó:
qm importdisk <vmid> watchzit-appliance.qcow2 local-lvm
Inicie a VM: a tela dela mostra o endereço do console e o token de configuração. Abra https://<endereço>:8443, aceite uma vez o certificado próprio do console, informe o token e crie o primeiro administrador com login em duas etapas. O appliance recebe o endereço por DHCP; na tela da VM, entre como wzadmin (primeira senha watchzit, que precisa ser trocada na hora) para definir um endereço fixo, o nome do servidor e o fuso horário. Para ter mais espaço, aumente o disco da VM: o appliance expande o sistema de arquivos na próxima inicialização.
2. ISO do appliance
watchzit-appliance.iso — inicie uma VM ou um servidor (2 vCPU, 2 GB de RAM, disco de 16 GB ou maior) por ela. Depois de 5 segundos começa a instalação automática: ela apaga o primeiro disco, instala Debian, PostgreSQL e WatchZit em cerca de 10 a 20 minutos e então mostra o endereço do console e o token de configuração.
3. Script de instalação
No Debian 12+, Ubuntu 22.04+, AlmaLinux ou Rocky Linux 9+ (x86-64), como root:
curl -fsSL https://github.com/Max-Zit/watchzit/releases/latest/download/install.sh | sudo sh
O script instala o PostgreSQL, baixa a versão mais recente, confere a assinatura e o checksum, cria o banco de dados com uma senha aleatória, ativa as atualizações automáticas de segurança, abre as portas 8443 e 8444 no firewalld ou ufw e mostra o endereço do console e o token de configuração. Rode-o de novo para atualizar. Opções depois de sh -s --: --version X, --db postgres://…, --no-auto-updates, --source URL. Para lê-lo antes:
curl -fsSLO https://github.com/Max-Zit/watchzit/releases/latest/download/install.sh
less install.sh
sudo sh install.sh
4. Pacotes e agentes
sudo apt install ./watchzit-server_X_amd64.deb # Debian, Ubuntu
sudo dnf install ./watchzit-server-X-1.x86_64.rpm # AlmaLinux, Rocky Linux
Crie um banco de dados e um usuário do PostgreSQL para o WatchZit, defina WATCHZIT_DB em /etc/watchzit/server.env e depois rode systemctl enable --now watchzit-server. O token de configuração fica em /var/lib/watchzit/setup-token.txt. Esses arquivos levam a versão no nome e estão na página da versão:
| Arquivo | O que é |
|---|---|
watchzit-server_X_amd64.deb, .rpm | O servidor, para instalação manual |
watchzit-agent-X-x64.msi | Agente para Windows — Windows 10/11 e Windows Server (x86-64) |
watchzit-agent_X_amd64.deb, .rpm, arm64 | Pacotes do agente para Linux em x86-64 e ARM64 |
watchzit-agent-X-linux-amd64, -arm64 | Agente para Linux como um único programa |
maxzit-launcher-X-x64.msi | MaxZit Launcher para Windows: abre dispositivos com programas locais |
| SHA256SUMS | Checksums dos programas e pacotes |
| SHA256SUMS-appliance | Checksums das imagens de VM e da ISO |
Instalar um agente
No console, abra Agentes e crie um código de registro (WZ1-…). A página oferece os downloads e os comandos exatos, já com o código.
msiexec /i watchzit-agent-x64.msi ENROLLCODE="WZ1-…" /qn # Windows (também GPO, Intune)
sudo apt install ./watchzit-agent_X_amd64.deb # pacote Linux, depois:
sudo watchzit-agent enroll --code "WZ1-…"
sudo systemctl start watchzit-agent
Para Linux, a página Agentes também mostra um comando único que baixa o agente do seu servidor, confere o SHA-256 dele e o instala como serviço watchzit-agent. Os agentes se atualizam sozinhos pelo console. Para transformar um agente em coletor remoto de uma filial, clique em Usar como coletor remoto na página do dispositivo dele.
Verificar um download
sha256sum -c SHA256SUMS --ignore-missing # programas e pacotes
sha256sum -c SHA256SUMS-appliance --ignore-missing # OVA, qcow2, zip VHDX, ISO
O servidor e o script de instalação conferem o manifesto assinado da versão antes de instalar qualquer coisa; veja Segurança.
Atualizações
Configurações → Atualizações e servidor mostra as versões novas e as instala, na hora ou automaticamente no horário escolhido — também a partir de arquivos enviados por você, para servidores sem internet. Só são instaladas versões assinadas com a chave de publicação do WatchZit; antes, o servidor faz backup do banco de dados e do programa e volta para a versão anterior se a nova não iniciar. O canal Testes oferece versões candidatas para um console de testes. A mesma página instala as atualizações do sistema operacional do appliance. O Backup da consola guarda cópias diárias, criptografadas se você quiser, numa pasta SFTP para restaurar numa máquina nova.