Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

adding documentation to change nextcloud data path #670

Open
wants to merge 6 commits into
base: testing
Choose a base branch
from
Open

adding documentation to change nextcloud data path #670

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
c5b8a6e
adding documentation to change nextcloud data path
Alexis-IMBERT Feb 27, 2024
b1318bd
Update doc/ADMIN.md
Alexis-IMBERT Feb 27, 2024
81d7e17
Update doc/ADMIN_fr.md
Alexis-IMBERT Feb 27, 2024
47b93bc
Update doc/ADMIN.md
Alexis-IMBERT Mar 4, 2024
9a7bfda
Update doc/ADMIN_fr.md
Alexis-IMBERT Mar 4, 2024
d65286a
Adding doc to change folder emplacement fr & en
Alexis-IMBERT Mar 4, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 22 additions & 1 deletion doc/ADMIN.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Related to https://github.com/YunoHost/doc/blob/master/pages/04.applications/10.docs/nextcloud/app_nextcloud.md#ii-migrate-nextcloud-data-to-a-larger-partition which is actually supposed to be removed and/or migrated to the app's ADMIN.md as a consequence of YunoHost/doc#2417

This old piece of doc actually seems to recommend a savage cp + edition of the config.php + the data dir setting

The symlink solution seems better but I don't remember why exactly but this ultimately also causes issues later on (maybe with backups if i remember correctly)

There is also https://yunohost.org/en/administer/tutorials/external_storage which to me sounds like the most reliable solution and uses bind mounts

Ideally we should harmonize all this because this is quite a reccuring question/issue and currently there's no way to move apps data in a simple yet long-term robust way


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
__DATA_DIR__
```

To modify the data folder, issue this command

```bash
yunohost app setting __APP__ data_dir -v /your/custom/data-path
Alexis-IMBERT marked this conversation as resolved.
Show resolved Hide resolved
```

Alexis-IMBERT marked this conversation as resolved.
Show resolved Hide resolved
### ONLYOFFICE integration

ONLYOFFICE is an online rich text document editor which can be integrated in Nextcloud
Expand All @@ -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.
20 changes: 20 additions & 0 deletions doc/ADMIN_fr.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Alexis-IMBERT marked this conversation as resolved.
Show resolved Hide resolved
```

Pour modifier le dossier data faite cette commande
```bash
yunohost app setting __APP__ data_dir -v /chemin/vers/nouvel/emplacement/data
```

Alexis-IMBERT marked this conversation as resolved.
Show resolved Hide resolved
### Intégration d'ONLYOFFICE

ONLYOFFICE est un éditeur de texte enrichi en ligne qui peut s'intégrer dans Nextcloud
Expand All @@ -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.