WatchZit

Scarica WatchZit

Ogni link punta alla versione più recente su GitHub. Le versioni sono firmate; il server si aggiorna da solo dalle stesse versioni.

Scegliete come installare il server

ModoIdeale perRequisiti
1. Immagine VM pronta all’usoImportare, avviare, accedere — in pochi minutiVMware, Proxmox/KVM o Hyper-V; nessun accesso a Internet
2. ISO dell’applianceUna nuova VM o un server fisico, senza interventiAccesso a Internet durante l’installazione
3. Script di installazioneUn server Debian, Ubuntu, AlmaLinux o Rocky Linux esistenteRoot e accesso a Internet
4. Pacchetti a manoIl vostro PostgreSQL, gestione della configurazione, server offlineIl pacchetto deb o rpm della versione

Il server richiede 2 vCPU, 2 GB di RAM e un disco da 16 GB. I browser raggiungono la console su TCP 8443; agenti e collettori remoti si connettono su TCP 8444.

1. Immagine VM pronta all’uso

OVA

VMware ESXi, Workstation, VirtualBox

watchzit-appliance.ova

ESXi Host Client: Create / Register VM → Deploy a virtual machine from an OVF or OVA file. vCenter: Deploy OVF Template.

QC

Proxmox VE e KVM

watchzit-appliance.qcow2

Create una VM senza disco (2 vCPU, 2 GB di RAM, rete VirtIO), importate il disco, collegatelo come disco di avvio SCSI e attivate il QEMU guest agent.

VHD

Hyper-V (generazione 1)

watchzit-appliance-vhdx.zip

Estraete l’archivio, create una VM di generazione 1 con 2 GB di RAM e scegliete il VHDX come disco.

Su Proxmox VE, dopo aver copiato l’immagine sul nodo:

qm importdisk <vmid> watchzit-appliance.qcow2 local-lvm

Avviate la VM: sul suo schermo compaiono l’indirizzo della console e il token di configurazione. Aprite https://<indirizzo>:8443, accettate una volta il certificato proprio della console, inserite il token e create il primo amministratore con accesso a due fattori. L’appliance ottiene l’indirizzo via DHCP; sullo schermo della VM accedete come wzadmin (prima password watchzit, da cambiare subito) per impostare un indirizzo fisso, il nome del server e il fuso orario. Per avere più spazio, ingrandite il disco della VM: l’appliance estende il file system al riavvio successivo.

2. ISO dell’appliance

watchzit-appliance.iso — avviate da qui una VM o un server (2 vCPU, 2 GB di RAM, disco da 16 GB o più). Dopo 5 secondi parte l’installazione automatica: cancella il primo disco, installa Debian, PostgreSQL e WatchZit in circa 10–20 minuti e poi mostra l’indirizzo della console e il token di configurazione.

3. Script di installazione

Su Debian 12+, Ubuntu 22.04+, AlmaLinux o Rocky Linux 9+ (x86-64), come root:

curl -fsSL https://github.com/Max-Zit/watchzit/releases/latest/download/install.sh | sudo sh

Lo script installa PostgreSQL, scarica la versione più recente, ne verifica firma e checksum, crea il database con una password casuale, attiva gli aggiornamenti di sicurezza automatici, apre le porte 8443 e 8444 in firewalld o ufw e mostra l’indirizzo della console e il token di configurazione. Rilanciatelo per aggiornare. Opzioni dopo sh -s --: --version X, --db postgres://…, --no-auto-updates, --source URL. Per leggerlo prima:

curl -fsSLO https://github.com/Max-Zit/watchzit/releases/latest/download/install.sh
less install.sh
sudo sh install.sh

4. Pacchetti e agenti

sudo apt install ./watchzit-server_X_amd64.deb      # Debian, Ubuntu
sudo dnf install ./watchzit-server-X-1.x86_64.rpm   # AlmaLinux, Rocky Linux

Create un database e un utente PostgreSQL per WatchZit, impostate WATCHZIT_DB in /etc/watchzit/server.env, poi systemctl enable --now watchzit-server. Il token di configurazione si trova in /var/lib/watchzit/setup-token.txt. Questi file hanno la versione nel nome e sono elencati nella pagina della versione:

FileCos’è
watchzit-server_X_amd64.deb, .rpmIl server, per l’installazione a mano
watchzit-agent-X-x64.msiAgente Windows — Windows 10/11 e Windows Server (x86-64)
watchzit-agent_X_amd64.deb, .rpm, arm64Pacchetti dell’agente Linux per x86-64 e ARM64
watchzit-agent-X-linux-amd64, -arm64Agente Linux come singolo programma
maxzit-launcher-X-x64.msiMaxZit Launcher per Windows: apre i dispositivi con programmi locali
SHA256SUMSChecksum dei programmi e dei pacchetti
SHA256SUMS-applianceChecksum delle immagini VM e della ISO

Installare un agente

Nella console aprite Agenti e create un codice di registrazione (WZ1-…). La pagina offre i download e i comandi esatti con il codice già inserito.

msiexec /i watchzit-agent-x64.msi ENROLLCODE="WZ1-…" /qn      # Windows (anche GPO, Intune)
sudo apt install ./watchzit-agent_X_amd64.deb              # pacchetto Linux, poi:
sudo watchzit-agent enroll --code "WZ1-…"
sudo systemctl start watchzit-agent

Per Linux la pagina Agenti mostra anche un unico comando che scarica l’agente dal vostro server, ne verifica lo SHA-256 e lo installa come servizio watchzit-agent. Gli agenti si aggiornano da soli dalla console. Per trasformare un agente in collettore remoto di una filiale, fate clic su Usa come collettore remoto nella pagina del suo dispositivo.

Verificare un download

sha256sum -c SHA256SUMS --ignore-missing             # programmi e pacchetti
sha256sum -c SHA256SUMS-appliance --ignore-missing   # OVA, qcow2, zip VHDX, ISO

Il server e lo script di installazione verificano il manifest firmato della versione prima di installare qualsiasi cosa; vedere Sicurezza.

Aggiornamenti

Impostazioni → Aggiornamenti e server mostra le nuove versioni e le installa, subito o automaticamente all’ora scelta — anche da file caricati, per i server senza Internet. Si installano solo versioni firmate con la chiave di rilascio di WatchZit; prima il server fa il backup del database e del programma e torna alla versione precedente se la nuova non si avvia. Il canale Test offre release candidate per una console di prova. La stessa pagina installa gli aggiornamenti del sistema operativo dell’appliance. Il Backup della console conserva copie giornaliere, cifrate se volete, in una cartella SFTP per il ripristino su una nuova macchina.