Choisir comment installer le serveur
Pas à pas, d’une VM vide aux premiers ordinateurs inscrits : Installer un RMM auto-hébergé et inscrire les premiers ordinateurs.
| Méthode | Idéal pour | Nécessite |
|---|---|---|
| 1. Image VM prête | Importer, démarrer, se connecter — en quelques minutes | VMware, Proxmox/KVM ou Hyper-V |
| 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 | Accès root et Internet |
| 4. Paquets à la main | Votre propre PostgreSQL, gestion de configuration | Le paquet deb ou rpm de la version |
| 5. Docker | Un hôte Docker, un NAS ou un labo existant | Docker avec le plugin Compose |
Le serveur nécessite 2 vCPU, 2–4 Go de RAM et un disque de 16 Go. Les agents s’y connectent sur TCP 8444 ; la console sur TCP 8443 est réservée à vos propres réseaux.
1. Image VM prête
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 et KVM
Créez une VM sans disque (2 vCPU, 2–4 Go de RAM, réseau VirtIO), importez le disque et attachez-le comme disque de démarrage SCSI.
Hyper-V (génération 1)
Décompressez, créez une VM de génération 1 avec 2–4 Go de RAM et choisissez le VHDX comme disque.
Sous Proxmox VE, après avoir copié l’image sur le nœud :
qm importdisk <vmid> rmmzit-appliance.qcow2 local-lvm
Démarrez la VM : son écran affiche l’adresse de la console et un jeton de configuration. Ouvrez https://<adresse>:8443, acceptez une fois le certificat auto-signé, saisissez le jeton et créez le premier administrateur avec connexion à deux facteurs. L’appliance obtient son adresse par DHCP ; sur l’écran de la VM, connectez-vous en tant que rzadmin (premier mot de passe rmmzit, à changer) pour définir une adresse fixe, le nom du serveur et le fuseau horaire.
2. ISO de l’appliance
rmmzit-appliance.iso — démarrez une VM ou un serveur dessus. Après 5 secondes, l’installation automatique commence : elle efface le premier disque, installe Debian, PostgreSQL et RMMZit en 10–20 minutes, puis affiche l’adresse de la console et le jeton de configuration.
3. Script d’installation
Sous Debian, Ubuntu, AlmaLinux ou Rocky Linux (x86-64), en root :
curl -fsSL https://github.com/Max-Zit/rmmzit/releases/latest/download/install.sh | sudo sh
Le script installe PostgreSQL, télécharge la dernière version, vérifie sa signature, crée la base et démarre le service. Relancez-le pour mettre à jour. Options : --version X, --db postgres://…, --no-auto-updates. Pour le lire d’abord :
curl -fsSLO https://github.com/Max-Zit/rmmzit/releases/latest/download/install.sh
less install.sh
sudo sh install.sh
4. Paquets et agents
sudo apt install ./rmmzit-server_X_amd64.deb # Debian, Ubuntu
sudo dnf install ./rmmzit-server-X-1.x86_64.rpm # AlmaLinux, Rocky Linux
Renseignez RMMZIT_DB dans /etc/rmmzit/server.env, puis systemctl enable --now rmmzit-server. Le jeton de configuration se trouve dans /var/lib/rmmzit/setup-token.txt. Ces fichiers portent la version dans leur nom et sont listés sur la page de la version :
| Fichier | Contenu |
|---|---|
rmmzit-server_X_amd64.deb, .rpm | Le serveur, pour une installation manuelle |
rmmzit-agent-X-x64.msi | Agent Windows — Windows 10, 11, Server 2016 et ultérieur |
rmmzit-agent-X-linux-amd64, -arm64 | Agent Linux pour x86-64 et ARM64 |
| SHA256SUMS | Sommes de contrôle des fichiers de la version |
| SOURCE-CODE.txt | Où obtenir le code source de tout ce que contiennent les images |
Installer un agent
Dans la console, ajoutez un client et un site et créez sur le site un code d’inscription (RZ1-…). La page du site propose les téléchargements et les commandes exactes — ainsi qu’un script de démarrage par stratégie de groupe et les paramètres Microsoft Intune.
msiexec /i rmmzit-agent-x64.msi /qn ENROLLCODE="RZ1-…" # Windows
sudo ./rmmzit-agent-linux-amd64 install --code "RZ1-…" # Linux (systemd)
Les agents se mettent à jour vers la version du serveur.
5. Docker
Le serveur existe aussi en image de conteneur, ghcr.io/max-zit/rmmzit, construite à partir du même paquet signé. Placez docker-compose.yml et .env.example dans un dossier, copiez .env.example en .env et définissez un mot de passe de base de données, puis :
docker compose up -d
docker compose exec rmmzit rmmzit-server -setup-token
Ports : 8443 (console), 8444 (agents). Mise à jour avec docker compose pull && docker compose up -d ; le serveur sauvegarde sa base avant qu’une nouvelle version la modifie. Le tag latest suit les versions officielles, testing les versions candidates.
Vérifier un téléchargement
sha256sum -c SHA256SUMS --ignore-missing
Le serveur, les agents et le script d’installation vérifient le manifeste signé de la version avant toute installation ; voir Sécurité.
Mise à jour
Paramètres → Mises à jour de RMMZit vérifie les nouvelles versions sur GitHub et les installe, automatiquement si vous le souhaitez. Seules les versions signées avec la clé de RMMZit sont installées ; le serveur sauvegarde d’abord sa base et revient en arrière si la nouvelle version ne démarre pas. Le canal Testing propose les versions candidates pour un serveur de test. Paramètres → Sauvegarde de la console conserve des sauvegardes quotidiennes de la base, des clés et des certificats pour une restauration sur une nouvelle machine.