1. Matériels

Jeedom peut être installé sur différents composants hardware :

  • un Raspberry pi 2 ou 3

  • un NAS Synology

  • tout système Linux basé sur Debian

Vous pouvez aussi acheter une box toute faite avec Jeedom de préinstallé qui contient en plus un service pack (plus de support et service) et des plugins offerts :

Voici 1 configurations "type" pour bien débuter avec Jeedom en Z-Wave :

  1. Raspberry pi 3 :

    • Un raspberry+casing ~ 50 €

    • Une clef Aeon Gen 5 ~ 60 €

    • Une micro carte SD ~ 7 €

    • Alimentation USB ~ 8 €

Soit un total de 125 € pour une box domotique open source avec une maîtrise complète de son installation.

Il est possible d’ajouter ou de changer par un Rfxcom, ou une clef enOcean.
Jeedom est un logiciel qui est et restera open source, son utilisation est entièrement gratuite et ne dépend pas d’un cloud ou d’un abonnement. Cependant certains plugins qui permettent d’augmenter les capacités de Jeedom ou son utilisation peuvent être payants et peuvent avoir besoin d’une connexion internet. Vous pouvez retrouver la liste des plugins ici
Service pack ? Quézako ? Vous pouvez voir ici les avantages des service packs

2. Sur Jeedomboard (hummingboard,mini+)

Vous trouverez ici la documentation pas à pas pour installer Jeedom sur les Jeedomboard (ou Hummingboard).

Le nom de l’image Jeedom peut être différent de celui des captures faites dans cette documentation

2.1. Etape 1 : Installation de Etcher

Vous devez télécharger le logicel Etcher ici puis l’installer sur votre pc

2.2. Etape 2 : Récupération de l’image de Jeedom

Vous devez aller ici, puis dans le dossier Images récuperer l’image jeedom-jeeboard-*.rar ou Jeedomboard__Debian_Jessie*.rar

install humming 1

2.3. Etape 3 : Décompression de l’image de Jeedom

Décompresser l’image de Jeedom (si vous n’avez rien pour le décompresser vous pouvez installer winrar), vous devez obtenir :

install humming 2
install humming 8

2.4. Etape 4 : Gravure de l’image sur la carte SD

Insérer votre carte SD dans votre ordinateur puis lancer le logiciel Ether, donner lui le chemin de l’image, le chemin de la carte SD et cliquez sur "flash". Le logiciel va graver la carte SD et verifier la gravure

Vous n’avez plus qu’à mettre la carte SD dans la Jeedomboard (ou Hummingboard), à brancher le réseau et l’alimentation, votre Jeedom va démarrer (5 min) et vous devriez le voir sur le réseau.

Les identifiants SSH sont jeedom/Mjeedom96

Pour la suite vous pouvez suivre la documentationhttps://github.com/jeedom/documentation/blob/master/premiers-pas/fr_FR/index.asciidoc[Premier pas avec Jeedom]


3. Sur Jeedomboard (hummingboard,mini+ via le script officiel)

Unresolved directive in index.asciidoc - include::Miniplushumingboard.asciidoc[]


4. Sur Synology

Vous trouverez ici la documentation pas à pas pour installer Jeedom un Synology (DSM 5.2 minimum).

4.1. Etape 1 : Installation de Docker

Aller sur le centre des paquets :

install synology 1

Cliquez sur tous, puis installez le paquet Docker

install synology 2

Attendez jusqu’à ce que l’installation soit finie :

install synology 3
Pour avoir accès au paquet Docker, il faut absolument avoir DSM 5.2 et un NAS compatible

4.2. Etape 2 : Récupération et installation des images Jeedom

Il faut Docker pour faire tourner Jeedom, le premier un docker Mysql qui contiendra la base de données et un 2ème qui contient Jeedom

Lancez l’application Docker :

install synology 4

4.2.1. MYSQL

Cliquez sur "Registre" :

install synology 5

Dans le champ de recherche tapez "mysql", selectionnez mysql et cliquez sur télécharger :

install synology 15

Validez ensuite la demande de version, le mieux étant de prendre la version latest :

install synology 14

Cliquez ensuite sur image, ici vous pouvez suivre l’avancement du téléchargement (peut prendre plusieurs dizaines de minutes) :

install synology 16

Une fois terminé, cliquez sur l’image puis lancer :

install synology 17

Donnez un nom à votre mysql ainsi qu’un port local redirigé vers le port 3306 du conteneur, puis faites suivant :

install synology 18

Faites suivant :

install synology 19

Cliquez sur "Paramètres avancés" :

install synology 34

Puis sur "Ajouter un dossier", et là, mettez le dossier voulu côté Synology (c’est dans ce dossier qu’il y aura tous les fichiers de la base de données) et /var/lib/mysql côté conteneur (attention à bien décocher "Lecture seule")

install synology 32

Cliquez sur "Environnement" puis "Ajoutez une variable" et mettant dans "Variable" : "MYSQL_ROOT_PASSWORD" et dans valeur mettez le mot de passe de BDD voulu (il servira plus tard). Puis validez :

install synology 33

Cochez "Exécuter ce conteneur lorsque l’assistant a terminé" puis cliquez sur "Appliquer".

4.2.2. Jeedom

Cliquez sur "Registre" :

install synology 5

Dans le champ de recherche, tapez "jeedom", sélectionnez jeedom/jeedom et cliquez sur télécharger :

install synology 20

Validez ensuite la demande de version, le mieux étant de prendre la dernière.

Cliquez ensuite sur image, ici vous pouvez suivre l’avancement du téléchargement (peut prendre plusieurs dizaines de minutes) :

install synology 21

Une fois terminé, cliquez sur l’image puis lancer :

install synology 22

Donnez un nom à votre jeedom ainsi qu’un port local redirigé vers le port 80 (ici 9080) et un vers le 22 (ici 9022) du conteneur, puis faites suivant :

install synology 23

Faites suivant :

install synology 24

Cliquez sur "Paramètres avancés"

install synology 25

Puis sur "Ajouter un dossier"

install synology 26

Choisissez un dossier sur votre Synology (c’est dans ce dossier qu’il y aura tous les fichiers jeedom), attention à bien décocher "Lecture seule"

install synology 27

Dans chemin d’accès, mettez /var/www/jeedom puis cliquez sur "Environnement" :

install synology 28

Cochez "Exécuter le conteneur à l’aide de privilèges élevés" puis validez le tout :

install synology 29

Cochez "Exécuter ce conteneur lorsque l’assistant a terminé" puis cliquez sur "Appliquer".

4.3. Etape 3 : Configuration de Jeedom

Il vous faut maintenant installer Jeedom, c’est très simple, allez sur IP_NAS:9080

install synology 31

Remplissez les champs en fonction de votre configuration (configuration du docker mysql installé précédemment) et validez.

L’addresse IP de la BDD est l’addresse IP du NAS, le port est celui redirigé du docker Mysql, le mot de passe est celui mis dans le docker Mysql. Le nom d’utilisateur est root et le nom de la base celui que vous voulez (conseillé Jeedom)
install synology 30
Si vous voulez un accès SSH, il vous faut dans les ports rediriger un port local vers le port 22 du conteneur, les identifiants SSH sont root/jeedom. Vous pouvez changer le mot de passe en initialisant la variable d’environement ROOT_PASSWORD à la valeur du mot de passe voulu.

Ensuite, vous pouvez suivre la documentation Premier pas avec Jeedom

5. Docker

Attention nous partons ici du principe que vous maitrisez déjà docker

Pour découvrir Jeedom vous pouvez aussi le faire tourner dans un conteneur Docker :

Prérequis : Avoir une machine ou une VM tournant sous Linux

5.1. Etape 1 : Installation de docker

docker est maintenant disponible sur toutes les distributions récentes. Pour l’installer sur une distribution

  • à base de rpm

$ yum install docker
  • à base de deb

$ apt-get update
$ apt-get install docker
$ apt-get install docker.io

5.2. Etape 2 : Installation d’une image mysql

Vous pouvez aussi installer mysql directement sur la machine hôte, dans ce cas il faut sauter cette étape.

J’utilise celle-ci. Pour l’installer :

docker pull mysql:latest

Puis la lancer :

sudo docker run --name jeedom-mysql -v /opt/jeedom/mysql:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=your-mysql-password -d mysql:latest

Avec :

  • jeedom-mysql : le nom du conteneur mysql

  • /opt/jeedom/mysql : le dossier de l’hote ou l’on doit stoker les données de MySql

  • your-mysql-password : le mot de passe root de l’instance MySql

5.3. Etape 3 : Installation d’une image Jeedom

Installation de l’image :

docker pull jeedom/jeedom

Puis lancez la :

sudo docker run --name jeedom-server --link jeedom-mysql:mysql --privileged -v /your/jeedom/path:/var/www/html -e ROOT_PASSWORD=your-root-password -p 9080:80 -p 9022:22 jeedom/jeedom

Avec :

  • jeedom-server : nom du docker jeedom voulu

  • /your/jeedom/path : répertoire où les données de Jeedom sont mise sur l’hôte

  • your-root-password : mot de passe root pour accéder à Jeedom en SSH

Il vous faut ensuite installer Jeedom en allant sur : IP_DOCKER:9080 et entrer les informations de connexion vers mysql :

install other

Pour la suite vous pouvez suivre la documentation Premier pas avec Jeedom

Pour le nom de l’hote MySql il faut mettre jeedom-mysql

6. Autre/DIY

Vous trouverez ici la documentation pour installer Jeedom sur la plupart des systèmes linux (testée et approuvée sur la distribution Debian)

Debian 8 est la distribution officiellement supportée, l’utilisation d’une autre distribution est à proscrire au risque d’obtenir comme réponse du support de devoir restaurer votre Jeedom sur une image officielle. Si vous ne maitriser pas un minimum les environnements Linux, nous vous conseillons de partir sur une image officielle (OVF) ou l’utilisation d’une Mini+ ou Smart (disponible prochainement).

Connectez-vous en SSH à votre système et faites :

wget https://raw.githubusercontent.com/jeedom/core/stable/install/install.sh
chmod +x install.sh
./install.sh

Il vous suffit ensuite d’aller sur IP_MACHINE_JEEDOM

Les identifiants par défaut sont admin/admin
Les arguments suivants sont utilisables : -w = dossier webserver -z = installation dependances z-wave -m = mot de passe root mysql désiré
./install.sh -w /var/www/html -z -m Jeedom

Ensuite vous pouvez suivre la documentation Premier pas avec Jeedom


7. PI/ Sur une carte SD

Vous trouverez ici la documentation pour installer Jeedom sur un raspberry PI avec une carte SD.

Debian 8 (jessie) est la distribution officiellement supportée, l’utilisation d’une autre distribution est à proscrire au risque d’obtenir comme réponse du support de devoir restaurer votre Jeedom sur une image officielle.

Strecht (Debian 9) n’est pas supportée pour le moment. Elle le sera en version 3.1

1/ Télécharger le dernière image "lite", c’est à dire sans interface graphique Ici

2/ Décompresser l’image avec winrar Ici

3/ Graver cette image sur une SD avec etcher par exemple ici

Pour des raisons de sécurité, l’accès SSH n’est plus activé par défaut sur cette distribution. Il faut donc l’activer

4/ Activer un accès SSH

Il faut créer sur la partition boot (la seule accessible sous windows) un fihier ssh vide. Il suffit de faire un clic droit : nouveau / document texte et le renommer en"ssh" sans aucune extension

Sous windows, dans l’explorateur il faut donc vérifier votre paramétrage dans affichage / options / modifier les options de dossiers et de recherche /

ExtensionFichier

5/ Démarrer le PI

Insérer votre carte SD, brancher le cable réseau, brancher l’alimentation.

6/ Se connecter en SSH

Identifier votre Pi sur le réseau

Il faut connaitre l’adresse Ip de votre PI. Plusieurs solutions :

  • Consulter la configuration DHCP dans votre routeur

  • Utiliser un scanner de port type "angyipscanner" ici

Etablir la connexion

Ensuite utiliser par exemple putty pour établir votre connexion Ici

Rentrer l’adresse de Ip de votre PI (ici 192.168.0.10) et cliquez sur open. Accepter le message par défaut relatif à la sécurité lors de la première connexion.

Connectez-vous avec les identifiants pi / raspberry

putty

Si vous choisissez d’ouvrir votre port 22 sur l’extérieur, vous devez impérativement modifier votre mot de passe utilisateur et root !!!! (commande passwd et sudo passwd)

7/ Lancer le script d’installation jeedom

wget https://raw.githubusercontent.com/jeedom/core/stable/install/install.sh

chmod +x install.sh

sudo ./install.sh

Le mot de passe sudo est également raspberry

En fonction de votre débit internet, l’installation peut prendre de 45 à 90 minutes. Vous ne devez surtout pas interrompre le processus avant la fin. A défaut, il faudra reprendre la totalité de la procédure.

Il vous suffit ensuite d’aller sur IP_MACHINE_JEEDOM

Les identifiants par défaut sont admin/admin
Les arguments suivants sont utilisables : -w = dossier webserver -z = installation dependances z-wave -m = mot de passe root mysql désiré
./install.sh -w /var/www/html -z -m Jeedom

Ensuite vous pouvez suivre la documentation Premier pas avec Jeedom