Installation

Un peu d’indulgence si vous trouvez des bugs, Gladys 4 est en beta pour l’instant :)


Raspberry Pi

Ce tutoriel vous explique comment installer Gladys sur Raspberry Pi !

Télécharger l’image Raspbian

Nous mettons à disposition une image Raspbian toute prête.

Télécharger l’image

L’image Raspbian est compressée dans un fichier zip, que vous devez dézipper afin d’arriver à un fichier .img.

Cloner l’image sur une carte SD

Je vous conseille pour cela le super outil Etcher (compatible Linux/MacOS/Windows).

Installez Etcher, branchez votre carte SD à votre ordinateur, et clonez le fichier .img sur la carte.

Etcher

Branchez votre Raspberry Pi

Branchez votre Raspberry Pi au réseau et au secteur afin qu’il démarre.

Attendez quelques minutes que le Pi boot et que Gladys démarre.

Accéder à Gladys

Vous pouvez accéder à Gladys en accédant à http://gladys.local sur n’importe quel navigateur sur le réseau.

Si cela ne marche pas, vous pouvez y accéder en tapant l’IP de votre Raspberry Pi sur votre navigateur. Pour trouver l’IP de votre Raspberry Pi, vous pouvez utiliser des apps comme (Network Scanner sur Android ou iNet sur iOS)


Docker

Sur Raspberry Pi

Ce tutoriel vous explique comment installer Gladys avec Docker sur Raspberry Pi.

Installer Docker sur Raspberry Pi

curl -sSL https://get.docker.com | sh
sudo usermod -aG docker pi

Ensuite, fermez votre session SSH puis reconnectez vous à votre Raspberry Pi.

Lancer Gladys

Si vous avez déjà lancé l’alpha auparavant, pensez à supprimer votre dossier /var/lib/gladysassistant, car nous avons fais des modifications à ce niveau entre l’alpha et la beta. Attention: vous perdrez les données de l’alpha!

Pour lancer Gladys, exécutez la commande suivante sur votre Raspberry Pi:

docker run -d \
--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 \
gladysassistant/gladys:4.0.0-beta-arm

Note:

  • Si vous êtes sur une architecture x64/x86, utilisez le tag 4.0.0-beta-amd64, soit une image gladysassistant/gladys:4.0.0-beta-amd64
  • -e TZ=Europe/Paris => Pour changer le fuseau horaire du container, vous pouvez modifier cette variable. Vous trouverez toutes les valeurs possibles sur cette list.

Mise à jour automatique avec Watchtower

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

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

Accéder à Gladys

Vous pouvez accéder à Gladys en tapant l’IP de votre Raspberry Pi sur votre navigateur. Pour trouver l’IP de votre Raspberry Pi, vous pouvez utiliser des apps comme (Network Scanner sur Android ou iNet sur iOS)

Sur n’importe quel système

Docker s’installe sur n’importe quel système, et vous permet de faire tourner Gladys n’impote où :

  • Un NAS Synology
  • Une VM Linux
  • Un PC Windows
  • Sous MacOS
  • N’importe où !

Installer Docker

Je vous conseille de vous rendre sur la documentation docker, et de lire la documentation lié à votre système.

Lancer Gladys

Pour lancer Gladys, exécutez la commande suivante sur votre Raspberry Pi:

docker run -d \
--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 \
gladysassistant/gladys:4.0.0-beta-amd64

Vous pouvez adapter dans la commande les ports exposés suivant votre système.

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


MacOS/Windows

Le process est presque le même que pour Raspberry Pi.

Install Docker Desktop

Vous devez d’abord installer Docker Desktop.

Suivez les instructions sur leur site.

Docker Desktop devrait normalement installer Kitematic. Si ce n’est pas le cas, rendez-vous sur le site de Kitematic.

Lancer Gladys

Vous devez lancer Kitematic.

Puis, dans l’interface, cherchez “gladysassistant”:

Kitematic gladys assistant

Sélectionnez le tag “4.0.0-beta-amd64”:

Kitematic gladys assistant

Cliquez sur “Create” pour lancer un nouveau container:

Kitematic gladys assistant

Puis lancez dans votre navigateur l’URL indiqué par Kitematic (ici, “http://localhost:32768”)

Kitematic gladys assistant

Hop, vous avez accès à Gladys!