Merge pull request 'Grocy' (#121) from evo-grocy into master

Reviewed-on: #121

docker-compose/grocy/docker-compose.yml

@@ -0,0 +1,29 @@
+## Discord Plex FR : https://discord.gg/3gtABCH
+## Version 2021-09-18
+##
+## Pour une aide à l'installation, consulter le README
+##
+version: "2.1"
+
+services:
+  grocy:
+    image: ghcr.io/linuxserver/grocy
+    container_name: grocy
+#    labels:
+#      - com.centurylinklabs.watchtower.enable=true
+    networks:
+     - grocy-network
+    environment:
+      - PUID=1000
+      - PGID=1000
+      - TZ=Europe/Paris
+    volumes:
+      - /volume1/docker/grocy/config:/config
+    ports:
+      - 9283:80
+    restart: unless-stopped
+
+networks:
+  grocy-network:
+    external:
+      name: grocy-network

docker-compose/grocy/readme.md

@@ -0,0 +1,97 @@
+Installation de Grocy
+============
+
+Bienvenue sur mon nouveau tutoriel. Celui-ci, je l'espere va vous apprendre à installer Grocy.
+
+**Grocy, c'est quoi ?**
+Grocy est une solution de gestion d'épicerie et de ménage auto-hébergée sur le Web pour votre maison.
+
+## Table des matières 
+- 1. [Prérequis](#1-prérequis)
+  - 1.a [Création des dossiers](#1-a-création-des-dossiers)
+  - 1.b [Modifications du .env](#1-b-modifications-du-env)
+  - 1.c [Transfert des fichiers dans /edition-videos](#1-c-transfert-des-fichiers-dans-edition-videos)
+- 2. [Création des conteneurs](#2-création-des-conteneurs)
+  - 2.a [Création du réseau](#2-a-création-du-réseau)
+  - 2.b [Création des conteneurs](#2-b-création-des-conteneurs)
+- 3. [Les Bases](#3-les-bases)
+  - 3.a [Commandes de bases ( Docker )](#3-a-commandes-de-bases-docker)
+  - 3.b [Accès aux interfaces ( WebUI )](#3-b-accès-aux-interfaces-webui)
+- 4. Dépannage ( Ce construira au fur et a mesure des questions )
+
+## 1. Prérequis
+
+- Dans le paragraphe 1.a nous allons les créer avec une ligne de commande, et dans le paragraphe 1.b nous allons modifier le .env afin qu'il utilise bien ces dossiers ( en fonction de leurs localisation sur votre machine ).
+
+### 1.a. Création des dossiers
+
+- Avec `cd` aller dans le dossier de votre choix, par exemple "docker".
+Exemple : Si votre dossier "docker" ce trouve dans /volume1, alors la commande sera :
+`cd /volume1/docker`
+
+- Maintenant que nous sommes dans le bon dossier, nous allons executer la commande suivante pour créer le dossier grocy qui contiendra la configuration de grocy :
+
+`mkdir -p grocy/config`
+
+### 1.b. Modifications des .env
+- Récupérer sur votre machine le fichier [docker-compose.yml](https://gitea.zoz-serv.org/Zoz/plex_fr_discord_repo/src/branch/master/docker-compose/grocy/docker-compose.yml).
+
+> Vous pouvez faire un clic droit - Enregistrer sous ... sur les liens ci-dessus pour télécharger les fichiers.
+
+- Dans le fichier `docker-compose.yml` vous allez devoir modifier plusieurs chose :
+
+**PUID et PGID** devront correspondre aux ID de votre utilisateurs, plus d'info ici : [Connaitre le PUID / PGID d'un utilisateur](https://www.forum-nas.fr/viewtopic.php?f=56&t=13213)
+
+Dans la ligne `/volume1/docker/grocy/config:/config`, la partie `/volume1/docker/grocy/config` doit correspondre au chemin vers le dossier grocy/config créé a l'étape 1.a.
+Dans ce cas, c'est : `/volume1/docker/grocy/config`
+
+### 1.c Transfert des fichiers dans /edition-videos
+- Une fois les modifications effectuées, il faut transfert le fichier ( docker-compose.yml ) dans le dossier `/grocy` précédemment créé ! Par exemple, avec FileZilla.
+
+## 2. Création des conteneurs
+### 2.a Création du réseau
+- On créé le reseau `grocy-network` necesaire au fonctionnement du conteneur :
+
+```
+docker network create grocy-network
+```
+
+### 2.b Création des conteneurs
+Maintenant que votre "stack" est prete rendez-vous dans le dossier `grocy`, dans mon cas `/volume1/docker/grocy` :
+```
+cd /volume1/docker/grocy/config
+```
+
+## 3. Les Bases
+Il est possible d'utilise n'importe qu'elle interface de gestion de conteneur*, ou SSH.
+
+Voici quelques commandes de base :
+
+**[Portainer](https://www.forum-nas.fr/viewtopic.php?f=56&t=14030) par exemple.*
+
+### 3.a Commandes de bases ( Docker )
+- Arreter un conteneur : `docker stop <nom_du_conteneur>`
+Exemple pour le conteneur **grocy** : `docker stop grocy`
+
+- Redémarrer un conteneur : `docker restart <nom_du_conteneur>`
+Exemple pour le conteneur **grocy** : `docker restart grocy`
+
+- Démarrer un conteneur : `docker start <nom_du_conteneur>`
+Exemple pour le conteneur **grocy** : `docker start grocy`
+
+- Supprimer un conteneur : `docker rm <nom_du_conteneur>`
+Exemple pour le conteneur **grocy** : `docker rm grocy`
+
+- Créer le conteneur : `docker-compose up -d`
+Cette commande permet de créer ou re-créer le conteneur présent dans le fichier docker-compose.yml.
+> Note : Vous devez etre dans la dossier contenant le fichier docker-compose.yml pour que cette commande fonctionne.
+
+### 3.b Accès aux interfaces ( WebUI )
+
+- L'acces à chaque service se fait via une WebUI ( Interface Web ), sur un port quil lui est propre.
+- Pour Grocy, c'est le port `9283`. Donc l'adresse sera sous la forme : `http://IP_DE_LA_MACHINE:9283`
+Exemple : Si l'adresse IP de votre machine est `192.168.1.10`, alors l'adresse d'accès sera : `http://192.168.1.10:9283`
+
+## 4. Aller plus loin
+
+A VENIR ...