From c5b8a6e3901b7b0d28fa8526feccd2dd005cceef Mon Sep 17 00:00:00 2001 From: Alexis IMBERT Date: Tue, 27 Feb 2024 22:53:07 +0100 Subject: [PATCH 1/6] adding documentation to change nextcloud data path --- doc/ADMIN.md | 23 ++++++++++++++++++++++- doc/ADMIN_fr.md | 20 ++++++++++++++++++++ 2 files changed, 42 insertions(+), 1 deletion(-) diff --git a/doc/ADMIN.md b/doc/ADMIN.md index 8d401d2f..32eb0f4b 100644 --- a/doc/ADMIN.md +++ b/doc/ADMIN.md @@ -2,12 +2,32 @@ You can run Nextcloud commands from the command line using: -``` +```bash sudo -u __APP__ php__PHPVERSION__ --define apc.enable_cli=1 __INSTALL_DIR__/occ ... ``` Alternatively, you may open a 'Nextcloud shell' with `sudo yunohost app shell __APP__`, then run `php occ ...` +### Change data folder location + +The following command shows the current location of the data folder. + +```bash +yunohost app setting __APP__ data_dir +``` + +After installation, the result should be : + +```bash +/home/yunohost.app/nextcloud +``` + +To modify the data folder, issue this command + +```bash +yunohost app setting __APP__ data_dir -v /your/custom/data-path +``` + ### ONLYOFFICE integration ONLYOFFICE is an online rich text document editor which can be integrated in Nextcloud @@ -19,6 +39,7 @@ For better performance and ARM64 support (Raspberry Pi, OLinuXino...), install t #### Alternative: With Nextcloud App (no ARM support, lower performance) Nextcloud features a direct integration of ONLYOFFICE through a Nextcloud app. + - Install *Community Document Server* application in your Nextcloud. That's the part that runs ONLYOFFICE server. - Install *ONLYOFFICE* application. That's the client part that will connect to an ONLYOFFICE server. - Then in Settings -> ONLYOFFICE (`https://__DOMAIN____PATH__/settings/admin/onlyoffice`), if you want to configure which file formats should be opened by ONLYOFFICE. diff --git a/doc/ADMIN_fr.md b/doc/ADMIN_fr.md index 06b76b12..5f53895a 100644 --- a/doc/ADMIN_fr.md +++ b/doc/ADMIN_fr.md @@ -8,6 +8,25 @@ sudo -u __APP__ php__PHPVERSION__ --define apc.enable_cli=1 __INSTALL_DIR__/occ Ou bien, vous pouvez ouvrir un "shell Nextcloud" avec `sudo yunohost app shell __APP__`, puis lancer `php occ ...` +### Changer l'emplacement du dossier data + +Avec la commande suivante vous pouvez voir l'emplacement actuel de dossier data. + +```bash +yunohost app setting __APP__ data_dir +``` + +Après installation le résultat devrait être : + +```bash +/home/yunohost.app/nextcloud +``` + +Pour modifier le dossier data faite cette commande +```bash +yunohost app setting __APP__ data_dir -v /chemin/vers/nouvel/emplacement/data +``` + ### Intégration d'ONLYOFFICE ONLYOFFICE est un éditeur de texte enrichi en ligne qui peut s'intégrer dans Nextcloud @@ -19,6 +38,7 @@ Pour de meilleures performances et le support de ARM64 (Raspberry Pi, OLinuXino. #### Alternative: avec l'application Nextcloud (pas de support ARM, performances limitées) Nextcloud inclut une intégration directe via une application Nextcloud. + - Installez l'application *Community Document Server* dans votre Nextcloud. C'est la partie qui fait tourner un serveur ONLYOFFICE. - Installez l'application *ONLYOFFICE*. C'est la partie cliente qui va se connecter au serveur ONLYOFFICE. - Ensuite dans les Paramètres -> ONLYOFFICE (`https://__DOMAIN____PATH__/settings/admin/onlyoffice`), si vous voulez configurer quels formats de fichier s'ouvrent avec ONLYOFFICE. From b1318bd83aa0de02c78ad0069695e99f44550d8c Mon Sep 17 00:00:00 2001 From: Alexis IMBERT <97242148+Alexis-IMBERT@users.noreply.github.com> Date: Tue, 27 Feb 2024 23:04:54 +0100 Subject: [PATCH 2/6] Update doc/ADMIN.md Co-authored-by: eric_G <46165813+ericgaspar@users.noreply.github.com> --- doc/ADMIN.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/ADMIN.md b/doc/ADMIN.md index 32eb0f4b..24e774d8 100644 --- a/doc/ADMIN.md +++ b/doc/ADMIN.md @@ -19,7 +19,7 @@ yunohost app setting __APP__ data_dir After installation, the result should be : ```bash -/home/yunohost.app/nextcloud +__DATA_DIR__ ``` To modify the data folder, issue this command From 81d7e17b40fd771593de4633479374ade37a56d8 Mon Sep 17 00:00:00 2001 From: Alexis IMBERT <97242148+Alexis-IMBERT@users.noreply.github.com> Date: Tue, 27 Feb 2024 23:17:44 +0100 Subject: [PATCH 3/6] Update doc/ADMIN_fr.md --- doc/ADMIN_fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/ADMIN_fr.md b/doc/ADMIN_fr.md index 5f53895a..a63c71e2 100644 --- a/doc/ADMIN_fr.md +++ b/doc/ADMIN_fr.md @@ -19,7 +19,7 @@ yunohost app setting __APP__ data_dir Après installation le résultat devrait être : ```bash -/home/yunohost.app/nextcloud +__DATA_DIR__ ``` Pour modifier le dossier data faite cette commande From 47b93bc5c64db6f5a9a99062e0d8c878d3410b9c Mon Sep 17 00:00:00 2001 From: Alexis IMBERT <97242148+Alexis-IMBERT@users.noreply.github.com> Date: Mon, 4 Mar 2024 21:43:43 +0100 Subject: [PATCH 4/6] Update doc/ADMIN.md --- doc/ADMIN.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/ADMIN.md b/doc/ADMIN.md index 24e774d8..c82cc67c 100644 --- a/doc/ADMIN.md +++ b/doc/ADMIN.md @@ -27,7 +27,9 @@ To modify the data folder, issue this command ```bash yunohost app setting __APP__ data_dir -v /your/custom/data-path ``` - +Change the permissions of the folder : +```bash +chown nextcloud:nextcloud /your/custom/data-path ### ONLYOFFICE integration ONLYOFFICE is an online rich text document editor which can be integrated in Nextcloud From 9a7bfdafeb59cf84c2afa58ce92ca6313195c281 Mon Sep 17 00:00:00 2001 From: Alexis IMBERT <97242148+Alexis-IMBERT@users.noreply.github.com> Date: Mon, 4 Mar 2024 21:43:50 +0100 Subject: [PATCH 5/6] Update doc/ADMIN_fr.md --- doc/ADMIN_fr.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/ADMIN_fr.md b/doc/ADMIN_fr.md index a63c71e2..b96ec01e 100644 --- a/doc/ADMIN_fr.md +++ b/doc/ADMIN_fr.md @@ -26,7 +26,9 @@ Pour modifier le dossier data faite cette commande ```bash yunohost app setting __APP__ data_dir -v /chemin/vers/nouvel/emplacement/data ``` - +Modifier les permissions du dossier : +```bash +chown nextcloud:nextcloud /your/custom/data-path ### Intégration d'ONLYOFFICE ONLYOFFICE est un éditeur de texte enrichi en ligne qui peut s'intégrer dans Nextcloud From d65286ad6afe27038e591dee2b3ef02edc04900d Mon Sep 17 00:00:00 2001 From: Alexis IMBERT Date: Mon, 4 Mar 2024 22:00:36 +0100 Subject: [PATCH 6/6] Adding doc to change folder emplacement fr & en --- doc/ADMIN.md | 51 ++++++++++++++++++++++++++++++++++-------------- doc/ADMIN_fr.md | 52 +++++++++++++++++++++++++++++++++++-------------- 2 files changed, 73 insertions(+), 30 deletions(-) diff --git a/doc/ADMIN.md b/doc/ADMIN.md index c82cc67c..46fd8b2f 100644 --- a/doc/ADMIN.md +++ b/doc/ADMIN.md @@ -10,26 +10,47 @@ Alternatively, you may open a 'Nextcloud shell' with `sudo yunohost app shell __ ### Change data folder location -The following command shows the current location of the data folder. +It may be worth changing the default location of the Nextcloud folder to store data on a second hard disk. -```bash -yunohost app setting __APP__ data_dir -``` +1. Find the current Nextcloud data path -After installation, the result should be : + ```bash + yunohost app setting __APP__ data_dir + ``` -```bash -__DATA_DIR__ -``` + This command should display : -To modify the data folder, issue this command + ```bash + __DATA_DIR__ + ``` + +1. Move Nextcloud data to the new location: + For the example, we'll use the `/media/storage/nextcloud` folder. + + ```bash + mv __DATA_DIR__ /media/stockage/nextcloud + ``` + +1. Change folder owner : + + ```bash + chown nextcloud:nextcloud /media/storage/nextcloud + ``` + +1. Create a symbolic link between the default folder and the new one: + + ```bash + ln -s /media/stockage/nextcloud __DATA_DIR__ + ``` + +1. Test Nextcloud files: + + ```bash + sudo -u nextcloud php8.2 --define apc.enable_cli=1 /var/www/nextcloud/occ files:scan --all + ``` + +You're done! Your data is now stored in the folder `/media/storage/nextcloud`. -```bash -yunohost app setting __APP__ data_dir -v /your/custom/data-path -``` -Change the permissions of the folder : -```bash -chown nextcloud:nextcloud /your/custom/data-path ### ONLYOFFICE integration ONLYOFFICE is an online rich text document editor which can be integrated in Nextcloud diff --git a/doc/ADMIN_fr.md b/doc/ADMIN_fr.md index b96ec01e..6fde10c0 100644 --- a/doc/ADMIN_fr.md +++ b/doc/ADMIN_fr.md @@ -10,25 +10,47 @@ Ou bien, vous pouvez ouvrir un "shell Nextcloud" avec `sudo yunohost app shell _ ### Changer l'emplacement du dossier data -Avec la commande suivante vous pouvez voir l'emplacement actuel de dossier data. +Il peut être intéressant de changer l'emplacement par défaut du dossier Nextcloud pour stocker les données sur un second disque dur. -```bash -yunohost app setting __APP__ data_dir -``` +1. Trouver le chemin actuel des data Nextcloud -Après installation le résultat devrait être : + ```bash + yunohost app setting __APP__ data_dir + ``` -```bash -__DATA_DIR__ -``` + Cette commande devrait afficher : + + ```bash + __DATA_DIR__ + ``` + +1. Déplacer les données Nextcloud au nouvel emplacement : + Pour l'exemple nous prendrons le dossier `/media/stockage/nextcloud` + + ```bash + mv __DATA_DIR__ /media/stockage/nextcloud + ``` + +1. Modifier le propriétaire du dossier : + + ```bash + chown nextcloud:nextcloud /media/stockage/nextcloud + ``` + +1. Créer un lien symbolique entre le dossier par défaut et le nouveau dossier : + + ```bash + ln -s /media/stockage/nextcloud __DATA_DIR__ + ``` + +1. Tester les fichiers Nextcloud : + + ```bash + sudo -u nextcloud php8.2 --define apc.enable_cli=1 /var/www/nextcloud/occ files:scan --all + ``` + +C'est fini ! Vos données sont maintenant stocké dans le dossier `/media/stockage/nextcloud` -Pour modifier le dossier data faite cette commande -```bash -yunohost app setting __APP__ data_dir -v /chemin/vers/nouvel/emplacement/data -``` -Modifier les permissions du dossier : -```bash -chown nextcloud:nextcloud /your/custom/data-path ### Intégration d'ONLYOFFICE ONLYOFFICE est un éditeur de texte enrichi en ligne qui peut s'intégrer dans Nextcloud