FR

Applications

Superviser son serveur avec Netdata

Installez Netdata sur Debian ou Ubuntu, protégez le tableau de bord avec Nginx, HTTPS et un mot de passe, puis recevez des alertes par e-mail.

7 min de lecture, mis à jour le 18 novembre 2026

Sur cette page

Vos valeurs

Renseignez-les une fois, les commandes du guide se mettent à jour.

Ce guide vous explique comment installer Netdata sur un VPS ou un serveur dédié sous Debian 12/13 ou Ubuntu 22.04/24.04. Netdata collecte chaque seconde les métriques du système (CPU, mémoire, disques, réseau, services) et les affiche dans un tableau de bord web.

À la fin du guide, vous disposerez :

  • d’un agent Netdata installé depuis le dépôt officiel, sur le canal stable ;
  • d’un tableau de bord accessible uniquement en HTTPS, derrière Nginx et un mot de passe ;
  • d’alertes par e-mail, dont une alerte personnalisée ;
  • d’une procédure de mise à jour et de sauvegarde.

Commander un serveur

Pour superviser vos services, HostMyServers propose plusieurs offres :

Prérequis

  • Un serveur sous Debian 12/13 ou Ubuntu 22.04/24.04
  • Un accès SSH avec un utilisateur disposant de sudo
  • Un nom de domaine avec un enregistrement A : netdata.votre-domaine.com doit pointer vers l’adresse IP du serveur
  • Environ 4 Gio d’espace disque libre : avec ses réglages par défaut, Netdata limite ses métriques à 3 Gio, auxquels s’ajoutent ses métadonnées
  • Un compte SMTP si vous voulez recevoir les alertes par e-mail

Ports utilisés

Port Protocole Rôle Accès
22 TCP SSH (ou votre port personnalisé) Ouvert, à restreindre si possible
80 TCP Validation Let’s Encrypt et redirection vers HTTPS Ouvert
443 TCP Tableau de bord via Nginx Ouvert
19999 TCP Agent Netdata Local uniquement (127.0.0.1)

Préparer le serveur

Mettez le système à jour et installez les outils nécessaires :

Terminal
sudo apt update
sudo apt upgrade -y
sudo apt install -y curl ufw nginx apache2-utils certbot python3-certbot-nginx

Configurer le pare-feu

Autorisez SSH avant d’activer UFW, sous peine de perdre l’accès au serveur. Si vous utilisez un autre port SSH, remplacez 22 par ce port.

Terminal
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp
sudo ufw allow 80,443/tcp
sudo ufw enable
sudo ufw status verbose

Le port 19999 n’apparaît pas dans ces règles : il reste donc fermé depuis l’extérieur. Pour aller plus loin, consultez le guide Sécuriser son serveur.

Installer Netdata

Téléchargez le script officiel, puis lancez-le avec le canal stable. Sans cette option, le script propose le canal nightly, qui reçoit des versions de développement.

Terminal
curl -fsSL https://get.netdata.cloud/kickstart.sh -o /tmp/netdata-kickstart.sh
sh /tmp/netdata-kickstart.sh --release-channel=stable --disable-telemetry

Le script détecte votre distribution, ajoute le dépôt Netdata et installe les paquets natifs. Il demande une confirmation et utilise sudo lorsque c’est nécessaire. L’option --disable-telemetry désactive l’envoi de statistiques anonymes.

Vérifiez ensuite le service et le type d’installation :

Terminal
sudo systemctl status netdata --no-pager
sudo netdata -W buildinfo | grep -E 'Installation Type|Install type:'
curl -s http://127.0.0.1:19999/api/v1/info | head -n 5

Le service doit être active (running), le type d’installation binpkg-deb, et la dernière commande doit renvoyer du JSON.

Limiter Netdata à l’interface locale

Ouvrez la configuration avec l’outil fourni par Netdata :

Terminal
cd /etc/netdata
sudo ./edit-config netdata.conf

Dans la section [web], ajoutez ou modifiez la ligne bind to :

Configuration
[web]
    bind to = 127.0.0.1

Redémarrez l’agent et contrôlez l’adresse d’écoute :

Terminal
sudo systemctl restart netdata
sudo ss -tlnp | grep 19999

La sortie doit indiquer 127.0.0.1:19999, et non 0.0.0.0:19999 ou *:19999.

Publier le tableau de bord avec Nginx

Créer le mot de passe

Créez un fichier d’identifiants. La commande vous demande de choisir un mot de passe pour l’utilisateur admin :

Terminal
sudo htpasswd -c /etc/nginx/.htpasswd-netdata admin
sudo chown root:www-data /etc/nginx/.htpasswd-netdata
sudo chmod 640 /etc/nginx/.htpasswd-netdata

Créer le site Nginx

Terminal
sudo nano /etc/nginx/sites-available/netdata.conf

Collez la configuration suivante en adaptant le domaine :

Nginx
upstream netdata_backend {
    server 127.0.0.1:19999;
    keepalive 64;
}

server {
    listen 80;
    listen [::]:80;
    server_name netdata.votre-domaine.com;

    location / {
        auth_basic "Netdata";
        auth_basic_user_file /etc/nginx/.htpasswd-netdata;

        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Server $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_pass http://netdata_backend;
        proxy_http_version 1.1;
        proxy_pass_request_headers on;
        proxy_set_header Connection "keep-alive";
        proxy_store off;
    }
}

Activez le site et rechargez Nginx :

Terminal
sudo ln -s /etc/nginx/sites-available/netdata.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

Activer HTTPS

Demandez un certificat Let’s Encrypt et activez la redirection vers HTTPS :

Terminal
sudo certbot --nginx -d netdata.votre-domaine.com -m admin@votre-domaine.com --agree-tos --no-eff-email --redirect
sudo certbot renew --dry-run

Pour plus de détails, consultez le guide Installer un certificat SSL avec Let’s Encrypt.

Vérifier l’accès

Depuis votre poste, lancez ces trois tests :

Terminal
curl -s -o /dev/null -w '%{http_code}\n' https://netdata.votre-domaine.com/
curl -s -o /dev/null -w '%{http_code}\n' -u admin https://netdata.votre-domaine.com/
curl -m 5 http://IP_SERVEUR:19999/
Test Résultat attendu
Sans identifiants 401
Avec identifiants 200
Accès direct au port 19999 Échec de connexion ou délai dépassé

Ouvrez ensuite https://netdata.votre-domaine.com dans votre navigateur et connectez-vous. Si l’interface vous propose de relier l’agent à Netdata Cloud, cette étape est facultative : le tableau de bord local fonctionne sans compte.

Configurer les alertes

Netdata est livré avec de nombreuses alertes prêtes à l’emploi (disque, mémoire, CPU, réseau, etc.). Pour afficher toutes celles qui sont chargées :

Terminal
curl -s 'http://127.0.0.1:19999/api/v1/alarms?all' | head -n 30

Permettre l’envoi d’e-mails

Netdata envoie ses e-mails avec la commande sendmail. Le paquet msmtp-mta la fournit et transmet les messages à votre serveur SMTP :

Terminal
sudo apt install -y msmtp msmtp-mta
sudo nano /etc/msmtprc

Si l’installation pose une question sur AppArmor, conservez le choix par défaut. Renseignez ensuite votre compte SMTP :

Texte
defaults
auth           on
tls            on
tls_trust_file /etc/ssl/certs/ca-certificates.crt
syslog         on

account        alertes
host           smtp.votre-domaine.com
port           587
from           netdata@votre-domaine.com
user           netdata@votre-domaine.com
password       VOTRE_MOT_DE_PASSE_SMTP

account default : alertes

Ce fichier contient un mot de passe : seul root doit pouvoir le modifier, et seul le groupe netdata doit pouvoir le lire.

Terminal
sudo chown root:netdata /etc/msmtprc
sudo chmod 640 /etc/msmtprc
printf 'Subject: Test msmtp\n\nMessage de test.\n' | sudo -u netdata msmtp alertes@votre-domaine.com

Choisir le destinataire

Terminal
cd /etc/netdata
sudo ./edit-config health_alarm_notify.conf

Modifiez ces trois variables :

Terminal
EMAIL_SENDER="netdata@votre-domaine.com"
SEND_EMAIL="YES"
DEFAULT_RECIPIENT_EMAIL="alertes@votre-domaine.com"

La modification s’applique dès la prochaine alerte. Envoyez une notification de test :

Terminal
sudo su -s /bin/bash netdata
export NETDATA_ALARM_NOTIFY_DEBUG=1
/usr/libexec/netdata/plugins.d/alarm-notify.sh test
exit

Vous devez recevoir trois messages de test, correspondant aux états WARNING, CRITICAL et CLEAR.

Ajouter une alerte personnalisée

Créez un fichier dans le dossier des alertes :

Terminal
sudo nano /etc/netdata/health.d/cpu-15min.conf

Cet exemple surveille l’utilisation moyenne du CPU sur 15 minutes :

Texte
    alarm: cpu_usage_15min
       on: system.cpu
   lookup: average -15m unaligned of user,system,softirq,irq,guest
    units: %
    every: 1m
     warn: $this > 80
     crit: $this > 95
    delay: down 15m multiplier 1.5 max 1h
  summary: CPU élevé sur 15 minutes
     info: Utilisation moyenne du CPU sur les 15 dernières minutes
       to: sysadmin

Rechargez les alertes, sans redémarrer l’agent, puis vérifiez que la vôtre est bien chargée :

Terminal
sudo netdatacli reload-health
curl -s 'http://127.0.0.1:19999/api/v1/alarms?all' | grep cpu_usage_15min

Mettre à jour Netdata

Le script d’installation active par défaut une mise à jour automatique quotidienne. Pour vérifier sa planification :

Terminal
systemctl list-timers netdata-updater.timer --no-pager

Selon le système, la planification peut aussi passer par cron si le minuteur systemd n’est pas utilisé. Pour lancer une mise à jour manuellement, relancez le script officiel :

Terminal
curl -fsSL https://get.netdata.cloud/kickstart.sh -o /tmp/netdata-kickstart.sh
sh /tmp/netdata-kickstart.sh

Pour désactiver les mises à jour automatiques :

Terminal
sudo /usr/libexec/netdata/netdata-updater.sh --disable-auto-updates

Sauvegarder et restaurer

Données Emplacement
Configuration /etc/netdata
Métriques /var/cache/netdata
Identité de l’agent et jeton éventuel /var/lib/netdata

Arrêtez l’agent pendant la copie des métriques, afin d’obtenir une sauvegarde cohérente :

Terminal
sudo systemctl stop netdata
sudo tar -czpf "/root/netdata-$(date +%F).tar.gz" /etc/netdata /var/cache/netdata /var/lib/netdata
sudo systemctl start netdata
sudo chmod 600 /root/netdata-*.tar.gz

Copiez ensuite l’archive hors du serveur. Sauvegardez aussi /etc/msmtprc et les fichiers Nginx si vous voulez reconstruire l’ensemble à l’identique.

Pour restaurer, réinstallez Netdata si nécessaire, puis :

Terminal
sudo systemctl stop netdata
sudo rm -rf /var/cache/netdata
sudo tar -xzpf /root/netdata-AAAA-MM-JJ.tar.gz -C /
sudo systemctl start netdata

En cas de problème

Erreur 502 Bad Gateway

Nginx n’arrive pas à joindre l’agent.

Terminal
sudo systemctl status netdata --no-pager
sudo ss -tlnp | grep 19999
sudo tail -n 30 /var/log/nginx/error.log

Vérifiez que l’agent tourne et que bind to correspond bien à l’adresse de l’upstream, ici 127.0.0.1.

Le navigateur redemande sans cesse le mot de passe

Contrôlez les droits du fichier et l’identifiant :

Terminal
sudo ls -l /etc/nginx/.htpasswd-netdata
sudo htpasswd -v /etc/nginx/.htpasswd-netdata admin

Le fichier doit être lisible par le groupe www-data. Une erreur Permission denied dans /var/log/nginx/error.log confirme un problème de droits.

Le port 19999 répond depuis Internet

Vérifiez que la section [web] se trouve bien dans /etc/netdata/netdata.conf, redémarrez l’agent, puis contrôlez sudo ss -tlnp | grep 19999 et sudo ufw status verbose.

Certbot échoue

Vérifiez que le domaine pointe vers le serveur avec getent hosts netdata.votre-domaine.com, que le port 80 est ouvert et que sudo nginx -t ne signale aucune erreur.

Les e-mails n’arrivent pas

  • Relancez le test alarm-notify.sh test et lisez sa sortie détaillée.
  • Consultez les journaux de msmtp avec sudo journalctl -t msmtp -n 30 --no-pager.
  • Si command -v sendmail ne renvoie rien, le paquet msmtp-mta n’est pas installé.
  • Une erreur Permission denied sur /etc/msmtprc indique un problème de droits sur ce fichier.
  • Si la connexion SMTP expire, testez un autre port indiqué par votre fournisseur de messagerie. Pour savoir si un filtrage s’applique à votre service, contactez le support depuis votre espace client.

Netdata occupe trop d’espace disque

Contrôlez l’occupation réelle, puis réduisez la rétention dans la section [db] de netdata.conf :

Terminal
sudo du -sh /var/cache/netdata
cd /etc/netdata
sudo ./edit-config netdata.conf
Configuration
[db]
    dbengine tier 0 retention size = 500MiB
    dbengine tier 1 retention size = 500MiB
    dbengine tier 2 retention size = 500MiB

Redémarrez ensuite l’agent avec sudo systemctl restart netdata.

Pour aller plus loin

Pour conserver des métriques de plusieurs serveurs et créer vos propres tableaux de bord, consultez le guide Installer Prometheus et Grafana.

Références