Draft: Documenting how to add additional space [DOT NOT MERGE UNTIL CLARIFIED]

doc/ADDITIONAL_STORAGE.fr.md

@@ -0,0 +1,111 @@
+### Ajouter de l'espace à Nextcloud
+La solution I. permet d'ajouter un lien vers un dossier local ou distant.  
+La solution II. permet de déplacer l'espace de stockage principal de Nextcloud.
+
+#### I. Ajouter un espace de stockage externe
+
+Paramètre => [Administration] Stockages externe.
+
+En bas de la liste vous pouvez rajouter un dossier (Il est possible de définir un sous dossier en utilisant la convention `dossier/sousDossier`.)  
+Sélectionner un type de stockage et indiquez les informations de connexion demandées.  
+Vous pouvez restreindre ce dossier à un ou plusieurs utilisateurs nextcloud avec la colonne `Disponible pour`.  
+Avec l'engrenage vous pouvez autoriser ou interdire la prévisualisation et le partage des fichiers.  
+Enfin cliquer sur la coche pour valider le dossier.
+
+#### II. Migrer les données de Nextcloud dans une partition plus grosse
+
+**Remarque** : Ce qui suit suppose que vous avez un disque dur monté sur `/media/stockage`. Référez-vous à [cet article](/external_storage) pour préparer votre système.
+
+**Remarque** : Remplacez `nextcloud` par le nom de son instance, si vous avez plusieurs apps Nextcloud installées.
+
+Commencez par éteindre le serveur web avec la commande :
+```bash
+systemctl stop nginx  
+```
+
+##### Choix de l'emplacement
+
+**Cas A : Stockage vierge, exclusif à Nextcloud**
+
+Pour l'instant seul root peut y écrire dans `/media/stockage` ; ce qui signifie que NGINX et Nextcloud ne pourront donc pas l'utiliser.
+
+```bash
+chown -R nextcloud:nextcloud /media/stockage
+chmod 775 -R /media/stockage
+```
+
+**Cas B : Stockage partagé, données déjà présentes, données Nextcloud dans un sous-dossier**
+
+Si vous souhaitez utiliser ce disque pour d'autres applications, vous pouvez créer un sous-dossier appartenant à Nextcloud.
+
+```bash
+mkdir -p /media/stockage/nextcloud_data
+chown -R nextcloud /media/stockage/nextcloud_data
+chmod 775 -R /media/stockage/nextcloud_data
+```
+
+##### Migrer les données
+
+Migrez vos données vers le nouveau disque. Pour ce faire *(soyez patient, cela peut être long)* :
+
+```bash
+Cas A : cp -ir /home/yunohost.app/nextcloud /media/stockage
+Cas B : cp -ir /home/yunohost.app/nextcloud /media/stockage/nextcloud_data
+```
+
+L'option `i` permet de vous demander quoi faire en cas de conflit de fichier, notamment si vous écrasez un ancien dossier de données Owncloud ou Nextcloud.  
+Pour vérifier que tout s'est bien passé, comparer ce qu'affichent ces deux commandes (le contenu doit être identique) :
+
+```bash
+ls -la /home/yunohost.app/nextcloud
+
+Cas A : ls -al /media/stockage
+Cas B : ls -al /media/stockage/nextcloud_data/nextcloud
+```
+
+##### Configurer Nextcloud
+
+Pour informer Nextcloud de son nouveau répertoire, modifiez le fichier `/var/www/nextcloud/config/config.php` avec la commande :
+
+```bash
+nano /var/www/nextcloud/config/config.php
+```
+
+Cherchez la ligne :
+
+```bash
+'datadirectory' => '/home/yunohost.app/nextcloud/data',
+```
+
+Que vous modifiez :
+
+```bash
+CAS A : 'datadirectory' => '/media/stockage',
+CAS B : 'datadirectory' => '/media/stockage/nextcloud_data/nextcloud/data',
+```
+
+Sauvegardez avec `ctrl+x` puis `y` ou `o` (dépend de la locale de votre serveur).
+
+Relancez le serveur web :
+
+```bash
+systemctl start nginx
+```
+
+Ajouter le fichier .ocdata
+```bash
+CAS A : nano /media/stockage/.ocdata
+CAS B : nano /media/stockage/nextcloud_data/nextcloud/data/.ocdata
+```
+Ajouter un espace au fichier pour pouvoir le sauvegarder
+
+Sauvegardez avec `ctrl+x` puis `y` ou `o` (dépend de la locale de votre serveur).
+
+Lancez un scan du nouveau répertoire par Nextcloud:
+
+```bash
+cd /var/www/nextcloud
+sudo -u nextcloud php8.1 --define apc.enable_cli=1 files:scan --all
+```
+
+C'est terminé. À présent testez si tout va bien, essayez de vous connecter à votre instance Nextcloud, envoyer un fichier, vérifiez sa bonne synchronisation.

doc/ADDITIONAL_STORAGE.md

@@ -0,0 +1,118 @@
+### Adding storage space
+
+Solution I. allows you to add a link to a local or remote folder.  
+Solution II. allows to move the main storage space of Nextcloud.
+
+#### I. Add an external storage space
+
+Parameter =>[Administration] External storage.
+
+At the bottom of the list you can add a folder (It is possible to define a subfolder using the `folder/subfolder` convention.)  
+Select a storage type and specify the requested connection information.  
+You can restrict this folder to one or more nextcloud users with the column `Available for`.  
+With the gear you can allow or prohibit previewing and file sharing.  
+Finally click on the check mark to validate the folder.
+
+#### II. Migrate Nextcloud data to a larger partition
+
+**Note**: The following assumes that you have a hard disk mounted on `/media/storage`. Refer to[this article](/external_storage) to prepare your system.
+
+**Note**: Replace `nextcloud` with the name of its instance, if you have several Nextcloud apps installed.
+
+First turn off the web server with the command:
+```bash
+systemctl stop nginx  
+```
+
+##### Choice of location
+
+**Case A: Blank storage, exclusive to Nextcloud**
+
+For the moment only root can write to it in `/media/storage`, which means that NGINX and Nextcloud will not be able to use it.
+
+```bash
+chown -R nextcloud:nextcloud /media/storage
+chmod 775 -R /media/storage
+```
+
+**Case B: Shared storage, data already present, Nextcloud data in a subfolder**
+
+If you want to use this disk for other applications, you can create a subfolder belonging to Nextcloud.
+
+```bash
+mkdir -p /media/storage/nextcloud_data
+chown -R nextcloud /media/storage/nextcloud_data
+chmod 775 -R /media/storage/nextcloud_data
+```
+
+##### Migrate data
+
+Migrate your data to the new disk. To do this *(be patient, it can take a long time)*:
+
+```bash
+Case A: cp -ia /home/yunohost.app/nextcloud /media/storage
+Case B: cp -ia /home/yunohost.app/nextcloud /media/storage/nextcloud_data
+```
+
+The `i` option allows you to ask yourself what to do if there is a file conflict, especially if you overwrite an old Owncloud or Nextcloud data folder.  
+To check that everything went well, compare what these two commands display (the content must be identical):
+
+```bash
+ls -la /home/yunohost.app/nextcloud
+
+Case A: ls -al /media/storage
+Case B: ls -al /media/storage/nextcloud_data/nextcloud
+```
+
+##### Configure Nextcloud
+
+To inform Nextcloud of its new directory, modify the `/var/www/nextcloud/config/config.php` file with the command:
+
+```bash
+nano /var/www/nextcloud/config/config.php
+```
+
+Look for the line:
+
+```bash
+'datadirectory' => '/home/yunohost.app/nextcloud/data',
+```
+
+That you modify:
+
+```bash
+CASE A:'datadirectory' =>'/media/storage',
+CASE B:'datadirectory' =>'/media/storage/nextcloud_data/nextcloud/data',
+```
+
+Save it with `ctrl+x` then `y` or `o` (depending on your server locale).
+
+Restart the web server:
+
+```bash
+systemctl start nginx
+```
+
+Add the.ocdata file
+```bash
+CASE A: nano /media/storage/.ocdata
+CASE B: nano /media/storage/nextcloud_data/nextcloud/data/.ocdata
+```
+Add a space to the file to be able to save it
+
+Back up with `ctrl+x` then `y` or `o` (depending on your server locale).
+
+Run a scan of the new directory by Nextcloud:
+
+```bash
+cd /var/www/nextcloud
+sudo -u nextcloud php8.1 --define apc.enable_cli=1 files:scan --all
+```
+
+Update the YunoHost setting, so automatic upgrades and backups know where the datadir is located:
+```bash
+Case A: yunohost app setting nextcloud datadir -v /media/storage
+Case B: yunohost app setting nextcloud datadir -v /media/storage/nextcloud_data/nextcloud/data/
+```
+
+It's over now. Now test if everything is fine, try connecting to your Nextcloud instance, upload a file, check its proper synchronization.