Scegliete come installare il server
| Modo | Ideale per | Requisiti |
|---|---|---|
| 1. Immagine VM pronta all’uso | Importare, avviare, accedere — in pochi minuti | VMware, Proxmox/KVM o Hyper-V; nessun accesso a Internet |
| 2. ISO dell’appliance | Una nuova VM o un server fisico, senza interventi | Accesso a Internet durante l’installazione |
| 3. Script di installazione | Un server Debian, Ubuntu, AlmaLinux o Rocky Linux esistente | Root e accesso a Internet |
| 4. Pacchetti a mano | Il vostro PostgreSQL, gestione della configurazione, server offline | Il 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
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
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.
Hyper-V (generazione 1)
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:
| File | Cos’è |
|---|---|
watchzit-server_X_amd64.deb, .rpm | Il server, per l’installazione a mano |
watchzit-agent-X-x64.msi | Agente Windows — Windows 10/11 e Windows Server (x86-64) |
watchzit-agent_X_amd64.deb, .rpm, arm64 | Pacchetti dell’agente Linux per x86-64 e ARM64 |
watchzit-agent-X-linux-amd64, -arm64 | Agente Linux come singolo programma |
maxzit-launcher-X-x64.msi | MaxZit Launcher per Windows: apre i dispositivi con programmi locali |
| SHA256SUMS | Checksum dei programmi e dei pacchetti |
| SHA256SUMS-appliance | Checksum 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.