Vous avez modifié un fichier .service sous Linux, puis vous avez lancé un redémarrage du service… et rien ne semble avoir changé. Dans beaucoup de cas, le problème ne vient pas du service lui-même, mais de systemd qui n’a pas encore relu sa configuration.
C’est là que la commande systemctl daemon-reload intervient. Elle ne redémarre pas votre application. Elle demande à systemd de recharger les fichiers d’unités, comme les services, timers, sockets ou mounts. Et cette nuance est importante si vous administrez un serveur.
À quoi sert systemctl daemon-reload ?
La commande systemctl daemon-reload force systemd à relire sa configuration. Elle est utile après une modification dans un fichier situé, par exemple, dans /etc/systemd/system/.
sudo systemctl daemon-reload
Concrètement, vous devez l’utiliser quand vous ajoutez, supprimez ou modifiez un fichier d’unité systemd. Exemple classique : vous changez la ligne ExecStart d’un service, vous ajoutez une variable dans Environment=, ou vous créez un nouveau fichier mon-service.service.
Sans ce rechargement, systemd peut continuer à travailler avec l’ancienne version du fichier. Vous pouvez alors redémarrer votre service plusieurs fois sans comprendre pourquoi votre changement n’est pas pris en compte.
daemon-reload ne redémarre pas le service
C’est le piège le plus fréquent. daemon-reload recharge la configuration de systemd, mais il ne relance pas automatiquement le service concerné.
Si vous avez modifié un fichier .service, la séquence propre ressemble souvent à ceci :
sudo systemctl daemon-reload
sudo systemctl restart mon-service.service
sudo systemctl status mon-service.service
La première commande recharge la définition. La deuxième redémarre le service avec cette nouvelle définition. La troisième permet de vérifier rapidement si le service est bien reparti, ou s’il plante au démarrage.
De mon côté, je préfère toujours vérifier le statut juste après, surtout sur un serveur distant. Une faute dans un chemin, une option invalide ou un droit insuffisant peut bloquer le service au redémarrage.
Quand faut-il lancer daemon-reload ?
Vous pouvez retenir une règle simple : dès que vous touchez à la définition systemd d’un service, lancez daemon-reload avant de redémarrer ce service.
- vous créez un nouveau fichier
.service; - vous modifiez
ExecStart,WorkingDirectory,UserouGroup; - vous ajoutez une dépendance avec
After=,Requires=ouWants=; - vous changez un timer systemd ;
- vous supprimez ou remplacez un fichier d’unité.
En revanche, si vous changez uniquement un fichier de configuration lu par votre application, comme /etc/nginx/nginx.conf ou un fichier .env, daemon-reload n’est pas toujours nécessaire. Dans ce cas, c’est souvent le service lui-même qu’il faut recharger ou redémarrer.
reload, restart et daemon-reload : ne mélangez pas tout
Les noms se ressemblent, mais les actions ne font pas la même chose.
systemctl daemon-reloadrecharge les fichiers d’unités systemd ;systemctl reload nginxdemande au service de relire sa propre configuration, si le service le supporte ;systemctl restart nginxarrête puis relance le service ;systemctl rebootredémarre toute la machine.
Sur un serveur en production, cette différence compte. Redémarrer un service peut couper une application quelques secondes. Redémarrer la machine coupe tout. daemon-reload, lui, est beaucoup plus léger : il remet simplement systemd à jour sur ses définitions.
Que vérifier après la commande ?
Après un daemon-reload, je vous conseille de vérifier le service ciblé plutôt que de supposer que tout est bon.
sudo systemctl status mon-service.service
sudo journalctl -u mon-service.service -n 50 --no-pager
La première commande vous donne l’état du service. La deuxième affiche les derniers logs, ce qui aide vite à repérer une erreur de chemin, une permission refusée ou une option inconnue.
Si vous travaillez en SSH, évitez aussi de tester une modification critique sans session de secours. Gardez une deuxième connexion ouverte quand vous touchez à un service réseau, surtout SSH, Nginx, Apache ou un service de firewall.
Pour résumer : systemctl daemon-reload est une commande simple, mais elle évite beaucoup de diagnostics inutiles. Elle ne corrige pas un service mal configuré, elle permet seulement à systemd de lire votre nouvelle configuration. Le vrai test reste toujours le redémarrage du service et la lecture des logs.
La page de manuel systemctl reste une bonne référence si vous voulez vérifier précisément le rôle des commandes systemd.