From c1f5dad579a076f37e1bf13fe1106ad616c7f191 Mon Sep 17 00:00:00 2001
From: Simon C <simonc@linux.com>
Date: Sun, 28 Nov 2021 16:36:00 +0100
Subject: [PATCH] docs(Nextcloud): Add more documentation

---
 nextcloud/README.md | 80 ++++++++++++++++++++++++++++++++++++---------
 1 file changed, 64 insertions(+), 16 deletions(-)

diff --git a/nextcloud/README.md b/nextcloud/README.md
index 2f04a15..76ff345 100644
--- a/nextcloud/README.md
+++ b/nextcloud/README.md
@@ -14,45 +14,93 @@ On peut trouver [la documentation ici][documentation] en anglais ou ici pour la
 
 ## Aide
 
-Exemple de commande :
+Commande pour se connecter à un serveur :
 
 ```sh
-docker exec --user www-data -it nextcloud bash
+docker exec --user www-data -it nextcloud-fpm ash
 
-docker-compose exec --user www-data nextcloud php occ db:add-missing-primary-keys
+docker-compose exec --user www-data nextcloud-fpm ash
 ```
 
 ## Configuration
 
 Il est possible de configurer certaines parties avec des variables d'environnement, mais ce n'est pas le cas de l'ensemble de la configuration.
 
-Voici les modifications que j'effectue :
+### Création d'un groupe
 
 ```
-docker-compose exec --user www-data nextcloud-fpm ash
-vi config/config.php
+export NC_GROUP=com-en-aubrac
+php occ group:add $NC_GROUP
 ```
+
+### Création d'un utilisateur
+
+```
+# La variable OC_PASS est spécifique pour l'utilisation de --password-from-env
+export OC_PASS=unmotdepasse!
+
+export NC_USER=simon
+export NC_NAME=Simon
+export NC_MAIL=simon@example.org
+export NC_QUOTA="180 GB"
+
+php occ user:add --password-from-env --display-name=$NC_NAME --group="$NC_GROUP" $NC_USER
+php occ user:setting $NC_USER settings email $NC_MAIL
+```
+
+### Quota
+
+Pour bien comprendre les quotas dans Nextcloud : https://docs.nextcloud.com/server/latest/user_manual/en/files/quota.html
+
+```
+export NC_USER=simon
+export NC_QUOTA="10 GB"
+php occ user:setting $NC_USER files quota "$NC_QUOTA"
+```
+
+### Langue
+
+Voici les commandes pour configurer le français :
+
+```
+php occ config:system:set force_language --value="fr"
+php occ config:system:set default_locale --value="fr_FR"
+php occ config:system:set force_locale --value="fr_FR"
+php occ config:system:set default_language --value="fr"
+php occ config:system:set default_phone_region --value="FR"
+```
+
+Une [issue](https://github.com/nextcloud/docker/issues/1544) a été ouverte et a été marqué avec le label `enhancement`. C'est donc à suivre.
+
+### imagemagick
+
+> Le module php-imagick n’a aucun support SVG dans cette instance. Pour une meilleure compatibilité, il est recommandé de l’installer.
+
+Pour résoudre ce problème il faut ajouter le paquet `imagemagick`
+
+```
+docker compose exec nextcloud-fpm apk add --no-cache imagemagick
+```
+
+### Pour l'optimisation de la génération des preview
+
 Ajout de la configuration suivante :
 ```
-  'default_language' => 'fr',
-  'default_locale' => 'fr_FR',
-  'default_phone_region' => 'FR',
   'defaultapp' => 'files',
   'preview_max_x' => 2048,
   'preview_max_y' => 2048,
   'jpeg_quality' => 60,
 ```
 
-Ajout de imagemagick :
-```
-docker-compose exec nextcloud-fpm apk add --no-cache imagemagick
-```
+## Application
 
-ou
+Suppression d'application :
 
 ```
-ssh <server>
-docker exec nextcloud-fpm apk add --no-cache imagemagick
+php occ app:disable dashboard
+php occ app:disable photos
+php occ app:disable weather_status
+php occ app:disable user_status
 ```
 
 ## PHP-FPM: remédier à server reached pm.max_children