WatchZit

WatchZit downloaden

Elke link wijst naar de nieuwste release op GitHub. Releases zijn ondertekend; de server werkt zichzelf bij vanuit dezelfde releases.

Kies hoe u de server installeert

ManierHet beste voorNodig
1. Kant-en-klare VM-imageImporteren, starten, aanmelden — in een paar minutenVMware, Proxmox/KVM of Hyper-V; geen internettoegang
2. Appliance-ISOEen nieuwe VM of fysieke server, zonder tussenkomstInternettoegang tijdens de installatie
3. InstallatiescriptEen bestaande Debian-, Ubuntu-, AlmaLinux- of Rocky Linux-serverRoot en internettoegang
4. Pakketten met de handUw eigen PostgreSQL, configuratiebeheer, offline serversHet deb- of rpm-pakket van de release

De server heeft 2 vCPU, 2 GB RAM en een schijf van 16 GB nodig. Browsers bereiken de console op TCP 8443, agents en externe collectors maken verbinding op TCP 8444.

1. Kant-en-klare VM-image

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 en KVM

watchzit-appliance.qcow2

Maak een VM zonder schijf (2 vCPU, 2 GB RAM, VirtIO-netwerk), importeer de schijf, koppel hem als SCSI-opstartschijf en schakel de QEMU guest agent in.

VHD

Hyper-V (generatie 1)

watchzit-appliance-vhdx.zip

Pak uit, maak een VM van generatie 1 met 2 GB RAM en kies de VHDX als schijf.

Op Proxmox VE, na het kopiëren van de image naar de node:

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

Start de VM: het scherm toont het consoleadres en het installatietoken. Open https://<adres>:8443, accepteer eenmalig het eigen certificaat van de console, voer het token in en maak de eerste beheerder aan met tweestapsaanmelding. De appliance krijgt zijn adres via DHCP; meld u op het scherm van de VM aan als wzadmin (eerste wachtwoord watchzit, moet direct worden gewijzigd) om een vast adres, de servernaam en de tijdzone in te stellen. Meer ruimte nodig? Vergroot de VM-schijf: de appliance vergroot zijn bestandssysteem bij de volgende start.

2. Appliance-ISO

watchzit-appliance.iso — start er een VM of server mee op (2 vCPU, 2 GB RAM, schijf van 16 GB of groter). Na 5 seconden begint de automatische installatie: die wist de eerste schijf, installeert Debian, PostgreSQL en WatchZit in ongeveer 10–20 minuten en toont daarna het consoleadres en het installatietoken.

3. Installatiescript

Op Debian 12+, Ubuntu 22.04+, AlmaLinux of Rocky Linux 9+ (x86-64), als root:

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

Het script installeert PostgreSQL, downloadt de nieuwste release, controleert de handtekening en de checksum, maakt de database aan met een willekeurig wachtwoord, zet automatische beveiligingsupdates aan, opent de poorten 8443 en 8444 in firewalld of ufw en toont het consoleadres en het installatietoken. Voer het opnieuw uit om bij te werken. Opties na sh -s --: --version X, --db postgres://…, --no-auto-updates, --source URL. Eerst lezen:

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

4. Pakketten en agents

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

Maak een PostgreSQL-database en -gebruiker voor WatchZit aan, zet WATCHZIT_DB in /etc/watchzit/server.env en voer daarna systemctl enable --now watchzit-server uit. Het installatietoken staat in /var/lib/watchzit/setup-token.txt. Deze bestanden hebben de versie in hun naam en staan op de releasepagina:

BestandWat
watchzit-server_X_amd64.deb, .rpmDe server, voor installatie met de hand
watchzit-agent-X-x64.msiWindows-agent — Windows 10/11 en Windows Server (x86-64)
watchzit-agent_X_amd64.deb, .rpm, arm64Pakketten van de Linux-agent voor x86-64 en ARM64
watchzit-agent-X-linux-amd64, -arm64Linux-agent als één programma
maxzit-launcher-X-x64.msiMaxZit Launcher voor Windows: opent apparaten met lokale programma’s
SHA256SUMSChecksums van de programma’s en pakketten
SHA256SUMS-applianceChecksums van de VM-images en de ISO

Een agent installeren

Open in de console Agents en maak een aanmeldcode (WZ1-…). De pagina biedt de downloads en de precieze opdrachten met de code erin.

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

Voor Linux toont de pagina Agents ook één opdracht die de agent van uw server downloadt, de SHA-256 controleert en hem installeert als service watchzit-agent. Agents werken zichzelf bij vanuit de console. Om een agent externe collector voor een vestiging te maken, klikt u op Gebruiken als externe collector op de pagina van zijn apparaat.

Een download controleren

sha256sum -c SHA256SUMS --ignore-missing             # programma's en pakketten
sha256sum -c SHA256SUMS-appliance --ignore-missing   # OVA, qcow2, VHDX-zip, ISO

De server en het installatiescript controleren het ondertekende releasemanifest voordat ze iets installeren; zie Beveiliging.

Bijwerken

Instellingen → Updates en server toont nieuwe releases en installeert ze, meteen of automatisch op een gekozen tijdstip — ook vanuit bestanden die u uploadt, voor servers zonder internet. Alleen releases die met de releasesleutel van WatchZit zijn ondertekend, worden geïnstalleerd; de server maakt eerst een back-up van zijn database en programma en gaat terug naar de oude versie als de nieuwe niet start. Het kanaal Test biedt releasekandidaten voor een testconsole. Op dezelfde pagina installeert u updates van het besturingssysteem van de appliance. Back-up van de console bewaart dagelijkse, desgewenst versleutelde back-ups in een SFTP-map om ze op een nieuwe machine terug te zetten.