From 8036adcfbef3aec8da4672c7fa9a64e326359acb Mon Sep 17 00:00:00 2001 From: NightPumpkin Date: Sat, 18 Sep 2021 18:07:35 +0200 Subject: [PATCH] Grocy --- docker-compose/grocy/docker-compose.yml | 29 ++++++++ docker-compose/grocy/readme.md | 97 +++++++++++++++++++++++++ 2 files changed, 126 insertions(+) create mode 100644 docker-compose/grocy/docker-compose.yml create mode 100644 docker-compose/grocy/readme.md diff --git a/docker-compose/grocy/docker-compose.yml b/docker-compose/grocy/docker-compose.yml new file mode 100644 index 0000000..5a813f7 --- /dev/null +++ b/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 diff --git a/docker-compose/grocy/readme.md b/docker-compose/grocy/readme.md new file mode 100644 index 0000000..15a3f1a --- /dev/null +++ b/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 ` +Exemple pour le conteneur **grocy** : `docker stop grocy` + +- Redémarrer un conteneur : `docker restart ` +Exemple pour le conteneur **grocy** : `docker restart grocy` + +- Démarrer un conteneur : `docker start ` +Exemple pour le conteneur **grocy** : `docker start grocy` + +- Supprimer un conteneur : `docker rm ` +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 ... -- 2.45.2