Choisissez comment installer le serveur
| Méthode | Idéal pour | Prérequis |
|---|---|---|
| 1. Image de VM prête à l’emploi | Importer, démarrer, se connecter — en quelques minutes | VMware, Proxmox/KVM ou Hyper-V ; sans accès à Internet |
| 2. ISO de l’appliance | Une nouvelle VM ou un serveur physique, sans intervention | Accès à Internet pendant l’installation |
| 3. Script d’installation | Un serveur Debian, Ubuntu, AlmaLinux ou Rocky Linux existant | Root et accès à Internet |
| 4. Paquets à la main | Votre propre PostgreSQL, gestion de configuration, serveurs hors ligne | Le paquet deb ou rpm de la version |
Le serveur a besoin de 2 vCPU, 2 Go de RAM et d’un disque de 16 Go. Les navigateurs accèdent à la console sur TCP 8443, les agents et les collecteurs distants se connectent sur TCP 8444.
1. Image de VM prête à l’emploi
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 et KVM
Créez une VM sans disque (2 vCPU, 2 Go de RAM, réseau VirtIO), importez le disque, attachez-le en SCSI comme disque de démarrage et activez l’agent invité QEMU.
Hyper-V (génération 1)
Décompressez, créez une VM de génération 1 avec 2 Go de RAM et choisissez le VHDX comme disque.
Sur Proxmox VE, après avoir copié l’image sur le nœud :
qm importdisk <vmid> watchzit-appliance.qcow2 local-lvm
Démarrez la VM : son écran affiche l’adresse de la console et le jeton de configuration. Ouvrez https://<adresse>:8443, acceptez une fois le certificat propre à la console, saisissez le jeton et créez le premier administrateur avec la connexion à deux facteurs. L’appliance obtient son adresse par DHCP ; sur l’écran de la VM, connectez-vous en tant que wzadmin (premier mot de passe watchzit, à changer immédiatement) pour définir une adresse fixe, le nom du serveur et le fuseau horaire. Pour plus d’espace, agrandissez le disque de la VM : l’appliance étend son système de fichiers au démarrage suivant.
2. ISO de l’appliance
watchzit-appliance.iso — démarrez une VM ou un serveur (2 vCPU, 2 Go de RAM, disque de 16 Go ou plus) dessus. Au bout de 5 secondes, l’installation automatique commence : elle efface le premier disque, installe Debian, PostgreSQL et WatchZit en 10 à 20 minutes environ, puis affiche l’adresse de la console et le jeton de configuration.
3. Script d’installation
Sur Debian 12+, Ubuntu 22.04+, AlmaLinux ou Rocky Linux 9+ (x86-64), en root :
curl -fsSL https://github.com/Max-Zit/watchzit/releases/latest/download/install.sh | sudo sh
Le script installe PostgreSQL, télécharge la dernière version, vérifie sa signature et sa somme de contrôle, crée la base de données avec un mot de passe aléatoire, active les mises à jour de sécurité automatiques, ouvre les ports 8443 et 8444 dans firewalld ou ufw et affiche l’adresse de la console et le jeton de configuration. Relancez-le pour mettre à jour. Options après sh -s -- : --version X, --db postgres://…, --no-auto-updates, --source URL. Pour le lire d’abord :
curl -fsSLO https://github.com/Max-Zit/watchzit/releases/latest/download/install.sh
less install.sh
sudo sh install.sh
4. Paquets et agents
sudo apt install ./watchzit-server_X_amd64.deb # Debian, Ubuntu
sudo dnf install ./watchzit-server-X-1.x86_64.rpm # AlmaLinux, Rocky Linux
Créez une base de données et un utilisateur PostgreSQL pour WatchZit, renseignez WATCHZIT_DB dans /etc/watchzit/server.env, puis systemctl enable --now watchzit-server. Le jeton de configuration se trouve dans /var/lib/watchzit/setup-token.txt. Ces fichiers portent la version dans leur nom et figurent sur la page de la version :
| Fichier | Contenu |
|---|---|
watchzit-server_X_amd64.deb, .rpm | Le serveur, pour une installation à la main |
watchzit-agent-X-x64.msi | Agent Windows — Windows 10/11 et Windows Server (x86-64) |
watchzit-agent_X_amd64.deb, .rpm, arm64 | Paquets de l’agent Linux pour x86-64 et ARM64 |
watchzit-agent-X-linux-amd64, -arm64 | Agent Linux sous forme d’un seul programme |
maxzit-launcher-X-x64.msi | MaxZit Launcher pour Windows : ouvre les appareils avec des programmes locaux |
| SHA256SUMS | Sommes de contrôle des programmes et des paquets |
| SHA256SUMS-appliance | Sommes de contrôle des images de VM et de l’ISO |
Installer un agent
Dans la console, ouvrez Agents et créez un code d’inscription (WZ1-…). La page propose les téléchargements et les commandes exactes, code compris.
msiexec /i watchzit-agent-x64.msi ENROLLCODE="WZ1-…" /qn # Windows (aussi GPO, Intune)
sudo apt install ./watchzit-agent_X_amd64.deb # paquet Linux, puis :
sudo watchzit-agent enroll --code "WZ1-…"
sudo systemctl start watchzit-agent
Pour Linux, la page Agents affiche aussi une commande unique qui télécharge l’agent depuis votre serveur, vérifie son SHA-256 et l’installe comme service watchzit-agent. Les agents se mettent à jour eux-mêmes depuis la console. Pour faire d’un agent un collecteur distant pour une agence, cliquez sur Utiliser comme collecteur distant sur la page de son appareil.
Vérifier un téléchargement
sha256sum -c SHA256SUMS --ignore-missing # programmes et paquets
sha256sum -c SHA256SUMS-appliance --ignore-missing # OVA, qcow2, zip VHDX, ISO
Le serveur et le script d’installation vérifient le manifeste signé de la version avant d’installer quoi que ce soit ; voir Sécurité.
Mises à jour
Paramètres → Mises à jour et serveur affiche les nouvelles versions et les installe, tout de suite ou automatiquement à l’heure choisie — y compris à partir de fichiers téléversés, pour les serveurs sans Internet. Seules les versions signées avec la clé de publication de WatchZit sont installées ; le serveur sauvegarde d’abord sa base de données et son programme et revient à l’ancienne version si la nouvelle ne démarre pas. Le canal Test propose des versions candidates pour une console de test. La même page installe les mises à jour du système d’exploitation de l’appliance. La Sauvegarde de la console conserve des copies quotidiennes, chiffrées si vous le souhaitez, dans un dossier SFTP pour une restauration sur une nouvelle machine.