Scegli come installare il server
Passo passo, da una VM vuota ai primi computer registrati: Installare un RMM self-hosted e registrare i primi computer.
| Metodo | Ideale per | Richiede |
|---|---|---|
| 1. Immagine VM pronta | Importa, avvia, accedi — in pochi minuti | VMware, Proxmox/KVM o Hyper-V |
| 2. ISO dell’appliance | Una nuova VM o un server fisico, senza interazione | Accesso a Internet durante l’installazione |
| 3. Script di installazione | Un server Debian, Ubuntu, AlmaLinux o Rocky Linux esistente | Accesso root e a Internet |
| 4. Pacchetti a mano | PostgreSQL proprio, gestione della configurazione | Il pacchetto deb o rpm della release |
| 5. Docker | Un host Docker, un NAS o un laboratorio esistente | Docker con il plugin Compose |
Il server richiede 2 vCPU, 2–4 GB di RAM e un disco da 16 GB. Gli agenti si collegano su TCP 8444; la console su TCP 8443 è solo per le tue reti.
1. Immagine VM pronta
VMware ESXi, Workstation, VirtualBox
ESXi Host Client: Create / Register VM → Deploy a virtual machine from an OVF or OVA file. vSphere: Deploy OVF Template.
Proxmox VE e KVM
Crea una VM senza disco (2 vCPU, 2–4 GB di RAM, rete VirtIO), importa il disco e collegalo come disco di avvio SCSI.
Hyper-V (generazione 1)
Estrai l’archivio, crea una VM di generazione 1 con 2–4 GB di RAM e scegli il VHDX come disco.
Su Proxmox VE, dopo aver copiato l’immagine sul nodo:
qm importdisk <vmid> rmmzit-appliance.qcow2 local-lvm
Avvia la VM: lo schermo mostra l’indirizzo della console e un token di configurazione. Apri https://<indirizzo>:8443, accetta una volta il certificato autofirmato, inserisci il token e crea il primo amministratore con accesso a due fattori. L’appliance ottiene l’indirizzo via DHCP; sullo schermo della VM accedi come rzadmin (prima password rmmzit, da cambiare) per impostare un indirizzo statico, il nome del server e il fuso orario.
2. ISO dell’appliance
rmmzit-appliance.iso — avvia da essa una VM o un server. Dopo 5 secondi parte l’installazione automatica: cancella il primo disco, installa Debian, PostgreSQL e RMMZit in 10–20 minuti e poi mostra l’indirizzo della console e il token di configurazione.
3. Script di installazione
Su Debian, Ubuntu, AlmaLinux o Rocky Linux (x86-64), come root:
curl -fsSL https://github.com/Max-Zit/rmmzit/releases/latest/download/install.sh | sudo sh
Lo script installa PostgreSQL, scarica la release più recente, ne verifica la firma, crea il database e avvia il servizio. Eseguilo di nuovo per aggiornare. Opzioni: --version X, --db postgres://…, --no-auto-updates. Per leggerlo prima:
curl -fsSLO https://github.com/Max-Zit/rmmzit/releases/latest/download/install.sh
less install.sh
sudo sh install.sh
4. Pacchetti e agenti
sudo apt install ./rmmzit-server_X_amd64.deb # Debian, Ubuntu
sudo dnf install ./rmmzit-server-X-1.x86_64.rpm # AlmaLinux, Rocky Linux
Imposta RMMZIT_DB in /etc/rmmzit/server.env, poi systemctl enable --now rmmzit-server. Il token di configurazione è in /var/lib/rmmzit/setup-token.txt. Questi file hanno la versione nel nome e sono elencati nella pagina della release:
| File | Contenuto |
|---|---|
rmmzit-server_X_amd64.deb, .rpm | Il server, per l’installazione manuale |
rmmzit-agent-X-x64.msi | Agente Windows — Windows 10, 11, Server 2016 e successivi |
rmmzit-agent-X-linux-amd64, -arm64 | Agente Linux per x86-64 e ARM64 |
| SHA256SUMS | Checksum dei file della release |
| SOURCE-CODE.txt | Dove trovare il codice sorgente di tutto ciò che è nelle immagini |
Installare un agente
Nella console aggiungi un cliente e una sede e crea sulla sede un codice di registrazione (RZ1-…). La pagina della sede offre i download e i comandi esatti — anche uno script di avvio di Criteri di gruppo e le impostazioni di Microsoft Intune.
msiexec /i rmmzit-agent-x64.msi /qn ENROLLCODE="RZ1-…" # Windows
sudo ./rmmzit-agent-linux-amd64 install --code "RZ1-…" # Linux (systemd)
Gli agenti si aggiornano da soli alla versione del server.
5. Docker
Il server è anche un’immagine container, ghcr.io/max-zit/rmmzit, creata dallo stesso pacchetto firmato. Metti docker-compose.yml e .env.example in una cartella, copia .env.example in .env e imposta una password del database, poi:
docker compose up -d
docker compose exec rmmzit rmmzit-server -setup-token
Porte: 8443 (console), 8444 (agenti). Aggiorna con docker compose pull && docker compose up -d; il server esegue il backup del database prima che una nuova versione lo modifichi. Il tag latest segue le release ufficiali, testing le release candidate.
Verificare un download
sha256sum -c SHA256SUMS --ignore-missing
Il server, gli agenti e lo script di installazione verificano il manifesto firmato della release prima di installare qualsiasi cosa; vedi Sicurezza.
Aggiornamento
Impostazioni → Aggiornamenti di RMMZit controlla le nuove release su GitHub e le installa, anche automaticamente. Vengono installate solo release firmate con la chiave di RMMZit; il server esegue prima il backup del database e torna indietro se la nuova versione non si avvia. Il canale Testing offre le release candidate per un server di prova. Impostazioni → Backup della console conserva backup giornalieri di database, chiavi e certificati per il ripristino su una nuova macchina.