WatchZit

Download WatchZit

Every link points to the newest release on GitHub. Releases are signed; the server updates itself from the same releases.

Choose how to install the server

WayBest forNeeds
1. Ready-made VM imageImport, start, sign in — in a few minutesVMware, Proxmox/KVM or Hyper-V; no internet access
2. Appliance ISOA new VM or a physical server, unattendedInternet access during installation
3. Install scriptAn existing Debian, Ubuntu, AlmaLinux or Rocky Linux serverRoot and internet access
4. Packages by handYour own PostgreSQL, configuration management, offline serversThe deb or rpm package of the release

The server needs 2 vCPU, 2 GB RAM and a 16 GB disk. Browsers reach the console on TCP 8443, agents and remote collectors connect on TCP 8444.

1. Ready-made 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 and KVM

watchzit-appliance.qcow2

Create a VM without a disk (2 vCPU, 2 GB RAM, VirtIO network), import the disk, attach it as SCSI boot disk and enable the QEMU guest agent.

VHD

Hyper-V (generation 1)

watchzit-appliance-vhdx.zip

Unzip, create a generation 1 VM with 2 GB RAM and choose the VHDX as its disk.

On Proxmox VE, after copying the image to the node:

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

Start the VM: its screen shows the console address and the setup token. Open https://<address>:8443, accept the console's own certificate once, enter the token and create the first administrator with two-factor sign-in. The appliance gets its address by DHCP; on the VM's screen, sign in as wzadmin (first password watchzit, must be changed at once) to set a fixed address, the server name and the time zone. To give it more space, enlarge the VM disk: the appliance grows its file system at the next start.

2. Appliance ISO

watchzit-appliance.iso — boot a VM or server (2 vCPU, 2 GB RAM, 16 GB or larger disk) from it. After 5 seconds the unattended installation starts: it erases the first disk, installs Debian, PostgreSQL and WatchZit in about 10–20 minutes, and then shows the console address and the setup token.

3. Install script

On Debian 12+, Ubuntu 22.04+, AlmaLinux or Rocky Linux 9+ (x86-64), as root:

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

The script installs PostgreSQL, downloads the newest release, checks its signature and checksum, creates the database with a random password, turns on automatic security updates, opens ports 8443 and 8444 in firewalld or ufw and prints the console address and the setup token. Run it again to update. Options after sh -s --: --version X, --db postgres://…, --no-auto-updates, --source URL. To read it first:

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

4. Packages and agents

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

Create a PostgreSQL database and user for WatchZit, set WATCHZIT_DB in /etc/watchzit/server.env, then systemctl enable --now watchzit-server. The setup token is in /var/lib/watchzit/setup-token.txt. These files carry the version in their name and are listed on the release page:

FileWhat
watchzit-server_X_amd64.deb, .rpmThe server, for installation by hand
watchzit-agent-X-x64.msiWindows agent — Windows 10/11 and Windows Server (x86-64)
watchzit-agent_X_amd64.deb, .rpm, arm64Linux agent packages for x86-64 and ARM64
watchzit-agent-X-linux-amd64, -arm64Linux agent as a single program
maxzit-launcher-X-x64.msiMaxZit Launcher for Windows: opens devices with local programs
SHA256SUMSChecksums of the programs and packages
SHA256SUMS-applianceChecksums of the VM images and the ISO

Install an agent

In the console, open Agents and create an enrollment code (WZ1-…). The page offers the downloads and the exact commands with the code in them.

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

On Linux the Agents page also shows a single command that downloads the agent from your server, checks its SHA-256 and installs it as the watchzit-agent service. Agents update themselves from the console. To make an agent a remote collector for a branch office, click Use as a remote collector on its device page.

Verify a download

sha256sum -c SHA256SUMS --ignore-missing             # programs and packages
sha256sum -c SHA256SUMS-appliance --ignore-missing   # OVA, qcow2, VHDX zip, ISO

The server and the install script verify the signed release manifest before installing anything; see Security.

Updating

Settings → Updates and server shows new releases and installs them, now or automatically at a chosen hour — also from files you upload, for servers without internet access. Only releases signed with the WatchZit release key are installed; the server backs up its database and program first and goes back to the old version if the new one does not start. The testing channel offers release candidates for a test console. The same page installs operating-system updates of the appliance. Console backup keeps daily, optionally encrypted backups on an SFTP folder for a restore on a new machine.