Documentation technique · ~10 min d'install

Installation de l'agent Mon Rempart

Guide complet pour installer l'agent sur vos serveurs Linux, Windows ou macOS. Pensé pour les DGS technique et les sysadmins. ~10 minutes par serveur.

1. Prérequis système

Systèmes supportés
  • •Debian 11+, Ubuntu 22.04+, RHEL 8+, AlmaLinux 9+
  • •Windows Server 2016+ (PowerShell 5.1+)
  • •macOS 12 Monterey ou supérieur
Ressources mini
  • •RAM : 256 MB libres
  • •Disque : 100 MB binaire + cache local
  • •CPU : 1 vCPU (pic à 2 vCPU pendant les sauvegardes)
Réseau
  • •Port 443/TCP outbound ouvert vers mon-rempart.fr
  • •Aucun port inbound nécessaire (sécurité)
  • •DNS résolu (TLS 1.2+ requis)
Permissions
  • •Linux : root pour l'install systemd
  • •Windows : compte Administrateur
  • •macOS : sudo requis pour launchd
L'agent ne nécessite aucun port entrant. Toute la communication avec Mon Rempart est initiée depuis votre serveur en HTTPS sortant. Aucun trou à percer dans votre pare-feu.

2. Récupérer votre clé API

Chaque agent est authentifié par une clé API liée à votre compte. Pour la récupérer :

  1. Connectez-vous à votre tableau de bord
  2. Section Agents → bouton Ajouter un agent
  3. Donnez un nom à l'agent (ex : serveur-mairie-01)
  4. Copiez la clé API affichée (commence par mra_)
La clé n'est affichée qu'une seule fois. Stockez-la dans un gestionnaire de secrets (ex: HashiCorp Vault, 1Password, BitWarden) ou directement dans le fichier d'environnement /etc/mon-rempart/agent.envavec permissions chmod 600.

3. Téléchargement + installation

Téléchargement + configuration env
# 1. Téléchargez le binaire
sudo curl -L https://mon-rempart.fr/downloads/mon-rempart-agent-linux \
    -o /usr/local/bin/mon-rempart-agent
sudo chmod +x /usr/local/bin/mon-rempart-agent

# 2. Créez l'utilisateur dédié + dossier de config
sudo useradd -r -s /bin/false monrempart
sudo mkdir -p /etc/mon-rempart
sudo chown monrempart:monrempart /etc/mon-rempart

# 3. Créez le fichier d'environnement
sudo tee /etc/mon-rempart/agent.env > /dev/null <<EOF
MONREMPART_API_KEY=votre_cle_api_ici
MONREMPART_API_URL=https://mon-rempart.fr
MONREMPART_BACKUP_PATHS=/var/www,/etc,/home
MONREMPART_EXCLUDE_PATHS=/var/log,/tmp,*.tmp,node_modules
EOF
sudo chmod 600 /etc/mon-rempart/agent.env
sudo chown monrempart:monrempart /etc/mon-rempart/agent.env
Remplacez votre_cle_api_ici par la clé récupérée à l'étape 2. Adaptez aussi MONREMPART_BACKUP_PATHS aux répertoires que vous souhaitez sauvegarder.

4. Configuration en service

L'agent doit tourner en permanence en arrière-plan, démarrer au boot, et redémarrer auto en cas de crash. Voici la conf Linux :

Service Linux
# Créez le service systemd
sudo tee /etc/systemd/system/mon-rempart-agent.service > /dev/null <<'EOF'
[Unit]
Description=Mon Rempart - Agent de sauvegarde
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=monrempart
Group=monrempart
EnvironmentFile=/etc/mon-rempart/agent.env
ExecStart=/usr/local/bin/mon-rempart-agent
Restart=always
RestartSec=10
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target
EOF

# Activez et démarrez le service
sudo systemctl daemon-reload
sudo systemctl enable mon-rempart-agent
sudo systemctl start mon-rempart-agent

# Vérification
sudo systemctl status mon-rempart-agent
sudo journalctl -u mon-rempart-agent -f

5. Vérification

Une fois le service démarré, vérifiez que tout fonctionne :

  1. Logs locaux

    Vérifiez les logs : sudo journalctl -u mon-rempart-agent -f

  2. Dashboard Mon Rempart

    Sous 1-2 minutes, votre serveur apparaît dans votre dashboard section Agents avec un badge vert "En ligne".

  3. Première sauvegarde

    L'agent lance une sauvegarde initiale dans les 15 minutes. Elle apparaît dans l'onglet Sauvegardes. Sur de gros volumes (>10 Go), comptez 1-2h.

6. Troubleshooting

L'agent ne démarre pas / erreur 'MONREMPART_API_KEY requise'
Vérifiez que les variables d'environnement sont bien chargées par le service. Sous Linux : sudo systemctl show mon-rempart-agent --property=Environment. Sous Windows : redémarrez le service après avoir défini les env vars système.
Erreur TLS / certificat expiré
Vérifiez l'heure système. Un décalage > 5 min casse TLS. Sous Linux : sudo timedatectl set-ntp true.
L'agent n'apparaît pas dans le dashboard après 5 min
  1. Testez la connectivité : curl https://mon-rempart.fr/api/agent/heartbeat
  2. Vérifiez les logs pour une erreur HTTP 401 (clé API invalide ?)
  3. Vérifiez que la clé API est bien valide depuis le dashboard
Premières sauvegardes très lentes
La première sauvegarde est complète (donc longue). Les suivantes sont incrémentales (très rapides). Sur un volume de 100 Go, comptez 2-4h initiales puis quelques minutes par jour ensuite.
Comment exclure des fichiers temporaires ?
Ajoutez les patterns dans MONREMPART_EXCLUDE_PATHSséparés par des virgules. Wildcards * supportés. Exemple : /tmp,/var/log,*.cache,node_modules

Besoin d'aide ?

Écrivez à contact@mon-rempart.fr en joignant les logs (anonymisez les API keys avant l'envoi). Réponse sous 24h ouvrées.

7. Désinstallation

Pour désinstaller proprement l'agent (Linux) :

Désinstallation Linux
sudo systemctl stop mon-rempart-agent
sudo systemctl disable mon-rempart-agent
sudo rm /etc/systemd/system/mon-rempart-agent.service
sudo rm /usr/local/bin/mon-rempart-agent
sudo rm -rf /etc/mon-rempart
sudo userdel monrempart
sudo systemctl daemon-reload
La désinstallation supprime l'agent local. Vos sauvegardes hébergées chez Mon Rempart restent disponibles selon la durée de rétention de votre formule. Pour résilier complètement votre compte, contactez contact@mon-rempart.fr.

Pour aller plus loin

Documentation produit
FAQ, restauration, etc.
Sécurité technique
Chiffrement, immuabilité, conformité
Contacter le support
contact@mon-rempart.fr