Sebw.infO

Dans cet article je vais vous expliquer comment installer facilement Librenms sous Docker.

J'aime bien Dockhand pour gerer les containers donc il fera parti de cet article ;)

Nous supposerons que vous avez installer le systeme d'exploitation Debian.

Cet article est testé sous Debian 13.

https://www.debian.org/index.fr.html

Sommaire : 

1. Installation des dépendances et des dépots
2. Installation de Docker
3. Installation de Dockhand
4. Installation de Librenms Docker
5. Gestions des différents parametres de Librenms avec Dockhand
6. Configurer la partie Email de Librenms (pour pouvoir envoyer des alertes)
7. Adapter les temps de sondage et d'intérrogation

1 : Installation des dépendances et des dépots

apt-get update

apt-get install apt-transport-https ca-certificates curl gnupg2

Ajouter le dépôt officiel Docker

curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

Ensuite, on ajoute le dépôt Docker à la liste des sources de notre machine :

echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list

apt-get update

2 : Installation de Docker

apt-get install docker-ce docker-ce-cli containerd.io

Démarrage automatique : 

systemctl enable docker

Voila Docker est installé ! 

3 : Installation de Dockhand

Dockhand va nous permettre de gerer les containers avec une interface graphique

Creez les répertoires pour acceuillir le docker-compose.yml dans /opt (ou comme vous voulez)

mkdir /opt/docker-compose
mkdir /opt/docker-compose/dockhand

cd /opt/docker-compose/dockhand/

nano docker-compose.yml

Inscrivez ceci dans le fichier docker-compose.yml

services:
  dockhand:
    image: fnsys/dockhand:latest
    container_name: dockhand
    restart: unless-stopped
    ports:
      - 3000:3000
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - dockhand_data:/app/data

volumes:
  dockhand_data:

Lancez le container 

docker compose up -d

Dockhand est installé !

Rendez vous à l'adresse http://ip:3000

Au départ il n'y a pas d'environnement de configuré, cliquez sur "Go to Settings"

Puis sur "Add environement"

Renseignez juste un nom (ici "mon serveur") et cliquez sur "Add"

Dockhand est installé et fonctionnel !

4 : Installation de Librenms Docker

Creer les répertoires dans opt

mkdir /opt/docker-compose/librenms

cd /opt/docker-compose/librenms/

apt install zip unzip

 

wget https://github.com/librenms/docker/archive/refs/heads/master.zip
unzip master.zip
cd docker-master/examples/compose

Editer le fichier ".env" pour renseignez un mot de passe de base de donnée

nano .env

TZ=Europe/Paris
PUID=1000
PGID=1000

MYSQL_DATABASE=librenms
MYSQL_USER=librenms
MYSQL_PASSWORD=monpassword

Lancez le container 

docker compose -f compose.yml up -d

Librenms est installé !

Rendez vous sur http://ip:8000

5 : Gestions des différents parametres de Librenms avec Dockhand

Ce qui est bien avec Dockhand c'est que vous n'avez pas besoin de taper une seule ligne de code pour configurer Librenms.

Vous verrez, dans l'onglet container que Librenms est en fait syndé en 7 containers

En détail c'est : 

• librenms = Le librenms CORE
• librenms_db = La base de donnée de Librenms 
• librenms_dispatcher = Tout ce qui concerne l'intérrogation et la découverte
• librenms_msmtpd = Tout ce qui touche aux emails
• librenms_redis = La partie cache
• librenms_snmptrad = La récupération des traps snmp (perso je ne m'en sers pas)
• librenms_syslogng = La partie des logs

Pour configurer un élément d'un container il suffit de cliquer sur le bouton "Edit" de chaque container (les boutons sur la droite)

Dans l'ordre de gauche à droite : 

• Stopper le container
• Mettre en pause le container
• Redémarrer le container
• Voir les détails du container
• Voir les fichiers du container
• Editer le container
• Voir les logs du container
• Entrer en mode console dans le container
• Supprimer le container

6: Configurer la partie Email de Librenms (pour pouvoir envoyer des alertes)

Editez le container librenms_msmtpd

Dans la parie "Environment variables" vous pouvez configurer le serveur d'emails

Une fois vos modifications éffectuées, redémarrez le container.

7 : Adapter les temps de sondage et d'intérrogation

J'aborde ce point car maintenant la configuration des temps de polling se fait dans l'interface de Librenms directement

Parametres globaux --> Sondeurs

Toute la configuration (avant dans le crontab) est la

Voila c'est fini, pour les environnements pas trop grand je trouve que c'est quand même plus simple à installer.