Aller au contenu principal

Installation avec Docker

Ce tutoriel vous explique comment installer Gladys manuellement avec Docker, quel que soit la machine sur laquelle vous faites tourner Gladys : Un Raspberry Pi, un NAS Synology, une VM linux, peu importe.

Installer Docker​

Si Docker n'est pas encore installé sur votre machine, vous pouvez l'installer en faisant :

curl -sSL https://get.docker.com | sh

Il faut maintenant ajouter votre utilisateur au groupe "docker" pour que votre utilisateur puisse exécuter les commandes Docker.

Si vous êtes sur un Raspberry Pi, il faut exécuter la commande pour l'utilisateur "pi" :

sudo usermod -aG docker pi

Ensuite, fermez votre session SSH, puis reconnectez-vous. L'ajout d'un utilisateur a un groupe ne prend effet qu'après une reconnexion.

Pour vérifier que Docker tourne bien, lancez la commande suivante :

docker ps

Vous devriez voir une liste des containers qui tournent sur la machine. Comme vous venez d'installer Docker, cette liste doit être vide normalement.

Si vous avez un problème lors de l'installation de Docker, je vous conseille de vous rendre sur la documentation Docker et de lire la documentation liée à votre système.

Lancer un container Gladys Assistant​

Pour lancer Gladys, exécutez la commande suivante :

docker run -d \
--log-driver json-file \
--log-opt max-size=10m \
--cgroupns=host \
--restart=always \
--privileged \
--network=host \
--name gladys \
-e NODE_ENV=production \
-e SERVER_PORT=80 \
-e TZ=Europe/Paris \
-e SQLITE_FILE_PATH=/var/lib/gladysassistant/gladys-production.db \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /var/lib/gladysassistant:/var/lib/gladysassistant \
-v /dev:/dev \
-v /run/udev:/run/udev:ro \
gladysassistant/gladys:v4

Note :

  • -e TZ=Europe/Paris => Pour changer le fuseau horaire du conteneur, vous pouvez modifier cette variable. Vous trouverez toutes les valeurs possibles sur cette liste.

  • -v /var/lib/gladysassistant : Le dossier de destination où Gladys va stocker toutes ses données. Vous pouvez changer la partie à gauche des ":" pour modifier le dossier de destination.

  • Cette image a été buildée pour toutes les architectures connues du marché. Vous pouvez donc lancer cette commande que vous soyez sur un Raspberry Pi, sur un NAS Synology, sur une VM Ubuntu, etc... Tout est possible !

  • Le --network=host n'est pas forcément adapté à tous les systèmes, il ne fonctionne pas sous MacOS ou Windows par exemple.

Mise à jour automatique avec Watchtower​

Vous pouvez utiliser Watchtower pour mettre automatiquement Gladys à jour quand une nouvelle version est disponible. Pour cela, lancez le conteneur :

docker run -d \
  --name watchtower \
  --restart=always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --cleanup --include-restarting

Accéder à Gladys Assistant sur le navigateur​

Vous pouvez accéder à Gladys en saisissant l'IP de votre machine sur votre navigateur, vous devez être sur le même réseau que la machine attention !

Pour trouver l'IP de votre machine, si vous êtes sur le même réseau local, vous pouvez utiliser des apps comme (Network Scanner sur Android ou iNet sur iOS).