Guide d'installation
Instructions pas à pas pour installer le serveur Xcellerate RMM avec Docker Compose.
Aperçu
La façon la plus rapide de déployer Xcellerate RMM est d'utiliser Docker Compose. Ce guide vous accompagne tout au long du processus — de la préparation de l'hôte à la vérification du serveur en fonctionnement. Si vous préférez une installation bare metal, reportez-vous aux notes d'installation avancée à la fin.
Concepts clés
- Stack Docker Compose — le serveur est livré sous forme d'un ensemble de conteneurs : interface web, API, workers d'arrière-plan, PostgreSQL et Redis.
- Fichier d'environnement (.env) — un fichier unique qui contient toute la configuration : identifiants de la base de données, paramètres TLS, relais SMTP et clé de licence.
- Volumes de données — des volumes Docker persistants pour la base de données et les fichiers téléversés, pour que vos données survivent aux redémarrages des conteneurs.
Installation pas à pas
Préparez l'hôte
Installez Docker et Docker Compose sur votre serveur. Sous Ubuntu : sudo apt update && sudo apt install -y docker.io docker-compose-v2. Ajoutez ensuite votre utilisateur au groupe docker : sudo usermod -aG docker $USER, puis déconnectez-vous et reconnectez-vous.
Téléchargez le paquet Xcellerate
Clonez le dépôt de déploiement : git clone https://github.com/rmmlabs/xcellerate-rmm.git && cd xcellerate-rmm. Il contient le docker-compose.yml et un fichier d'exemple .env.example.
Configurez les variables d'environnement
Copiez le fichier d'exemple : cp .env.example .env. Ouvrez .env dans votre éditeur et définissez au minimum : SERVER_HOSTNAME, DB_PASSWORD et ADMIN_EMAIL. Le fichier est bien commenté — chaque variable explique son rôle.
Démarrez la stack
Exécutez docker compose up -d. Docker télécharge les images (~1.2 GB au premier lancement), crée les volumes et démarre tous les services. L'opération prend généralement 2–4 minutes.
Vérifiez l'installation
Ouvrez https://help.comodo.com/uploads/Comodo%20One/6e175807820c03aca9839d66e42cbef4/5eac818f1e1c4adc19d335055b06586b/86591a8e70c8559c6cbe59827974324a/c1_rmm_install6.png dans un navigateur. Vous devez voir l'écran de connexion de Xcellerate RMM. Si vous utilisez un certificat auto-signé, votre navigateur affiche un avertissement de sécurité — c'est normal.
Activer TLS avec Let's Encrypt
En production, activez le TLS automatique. Définissez TLS_MODE=letsencrypt et [email protected] dans votre fichier .env, puis redémarrez la stack. Le reverse proxy intégré obtient et renouvelle automatiquement les certificats.
# Extrait du fichier .env
SERVER_HOSTNAME=rmm.yourcompany.com
TLS_MODE=letsencrypt
[email protected]Conseils et bonnes pratiques
- Utilisez toujours un nom de domaine complet (FQDN) pour
SERVER_HOSTNAME— les agents s'en servent pour se connecter. - Choisissez un
DB_PASSWORDfort et unique. Évitez les caractères spéciaux qui devraient être échappés dans un shell. - Sauvegardez le fichier
.envséparément — il contient les identifiants de votre base de données et votre clé de licence. - Planifiez la mise à jour automatique des images Docker avec une tâche cron ou Watchtower pour rester sur les derniers correctifs.