Choose how to install the server
| Way | Best for | Needs |
|---|---|---|
| 1. Ready-made VM image | Import, start, sign in — in a few minutes | VMware, Proxmox/KVM or Hyper-V; no internet access |
| 2. Appliance ISO | A new VM or a physical server, unattended | Internet access during installation |
| 3. Install script | An existing Debian, Ubuntu, AlmaLinux or Rocky Linux server | Root and internet access |
| 4. Packages by hand | Your own PostgreSQL, configuration management, offline servers | The 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
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 and KVM
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.
Hyper-V (generation 1)
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:
| File | What |
|---|---|
watchzit-server_X_amd64.deb, .rpm | The server, for installation by hand |
watchzit-agent-X-x64.msi | Windows agent — Windows 10/11 and Windows Server (x86-64) |
watchzit-agent_X_amd64.deb, .rpm, arm64 | Linux agent packages for x86-64 and ARM64 |
watchzit-agent-X-linux-amd64, -arm64 | Linux agent as a single program |
maxzit-launcher-X-x64.msi | MaxZit Launcher for Windows: opens devices with local programs |
| SHA256SUMS | Checksums of the programs and packages |
| SHA256SUMS-appliance | Checksums 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.