Développement de la doc de nextcloud et restructuration de la page

This commit is contained in:
Plumf 2019-09-28 22:09:11 +02:00
parent 36594392c5
commit a9ffeddea5
5 changed files with 134 additions and 89 deletions

View file

@ -1,9 +1,31 @@
# Add storage space
# <img src="/images/nextcloud_logo.png" alt="logo de Nextcloud"> Nextcloud
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.
- [Discovering the Nextcloud environment](#EnvironmentNextcloud)
- [Mobile and computer client software](#ClientSoftware)
- [Useful Manipulations & Problems Encountered](#UtileManipulations)
- [Add space to Nextcloud](#AddSpace)
- [Third Party Applications](#AppsTiers)
- [Useful links](#UsefulLinks)
## I) Add an external storage space
Nextcloud is a file hosting service, many applications can be installed to offer it new features such as a calendar, a directory, notes and many others (you can find some applications in the[third-party applications] part (#AppsTiers) but there are many others depending on your needs).
## Discovering the Nextcloud environment <a name="EnvironmentNextcloud"></a>
Due to the creation of Nextcloud, a database with third-party applications to install, this chapter will only concern the nextcloud database without added applications. More information on applications in the dedicated section or in the nextcloud application catalogue: [apps.nextcloud.com](https://apps.nextcloud.com).
Nextcloud is before a cloud service (like Seafile and others), it allows synchronization and file sharing on the Internet and between several terminals (computers, smartphone) but also with several people.
## Mobile and computer client software <a name="ClientSoftware"></a>
There are client software for all platforms. You can find them on the official nextcloud website: https://nextcloud.com/install/#install-clients
## Useful Manipulations & Problems Encountered <a name="UtileManipulations"></a>
### Add storage space <a name="AddSpace"></a>
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.
@ -13,7 +35,7 @@ You can restrict this folder to one or more nextcloud users with the column `Ava
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
#### 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_en) to prepare your system.
@ -24,9 +46,9 @@ First turn off the web server with the command:
systemctl stop nginx
```
#### Choice of location
##### Choice of location
#### Case A: Blank storage, exclusive to Nextcloud
**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.
@ -35,7 +57,7 @@ chown -R nextcloud:nextcloud /media/storage
chmod 775 -R /media/storage
```
#### Case B: Shared storage, data already present, Nextcloud data in a subfolder
**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.
@ -45,7 +67,7 @@ chown -R nextcloud /media/storage/nextcloud_data
chmod 775 -R /media/storage/nextcloud_data
```
#### Migrate data
##### Migrate data
Migrate your data to the new disk. To do this *(be patient, it can take a long time)*:
@ -54,8 +76,7 @@ Case A: cp -ir /home/yunohost.app/nextcloud /media/storage
Case B: cp -ir /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.
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
@ -65,7 +86,7 @@ Case A: ls -al /media/storage
Case B: ls -al /media/storage/nextcloud_data/nextcloud
```
#### Configure Nextcloud
##### Configure Nextcloud
To inform Nextcloud of its new directory, modify the `/var/www/nextcloud/config/config.php` file with the command:
@ -112,44 +133,14 @@ sudo -u nextcloud php occ files:scan --all
It's over now. Now test if everything is fine, try connecting to your Nextcloud instance, upload a file, check its proper synchronization.
# The KeeWeb application
The KeeWeb application is a password manager integrated into Nextcloud. For example, it allows you to read a KeePass file (*.kdbx*) stored on your Nextcloud instance.
But sometimes Nextcloud does not let the application support these files, which makes it impossible to read them from KeeWeb. To remedy this,
[a solution](https://github.com/jhass/nextcloud-keeweb/issues/34) exists.
Go to the Nextcloud configuration directory:
```bash
cd /var/www/nextcloud/config/
```
If it does not exist, create the *mimetypemapping.json* file whose owner is the user *nextcloud* :
```bash
sudo su nextcloud -c "nano mimetypemapping.json"
```
Then add in this file the following text:
```bash
{
"kdbx": ["x-application/kdbx"]
}
```
Save the file (**CTRL** + **o**) and exit nano (**CTRL** + **c**).
Now the problem is fixed.
# Nextcloud and Cloudflare
### Nextcloud and Cloudflare
If you use Cloudflare for your DNS, *which may be useful if you have a dynamic IP*, you will most likely have authentication problems with the Nextcloud application. On the Internet many people propose to create a rule that disables all options related to security and Cloudflare speed for the url pointing to your Nextcloud instance. Although it works, it is not the optimal solution. I propose, certainly to create a rule for the url pointing to your Nextcloud instance but to disable only 2 options. So here's how:
## Cloudflare Page Rules
#### Cloudflare Page Rules
In the Cloudflare control panel select your domain and find Page Rules
the url in your address bar will look like this: https://dash.cloudflare.com/*/domain.tld/page-rules
the url in your address bar will look like this: https://dash.cloudflare.com/*/domain.tld/page-rules
#### Add a rule
@ -163,4 +154,14 @@ The options to disable (Off) are:
- Rocket Loader
- Email Obfuscation
Save and clean your caches (Cloudflare, browser,...) and that's it.
Save and clean your caches (Cloudflare, browser,...) and that's it.
## Third Party Applications <a name="AppsTiers"></a>
+ [KeeWeb](app_nextcloud_keeweb)
## Useful links <a name="UsefulLinks"></a>
+ Official website : [nextcloud.com](https://nextcloud.com/)
+ Application catalogue for nextcloud : [apps.nextcloud.com](https://apps.nextcloud.com/)
+ Find help and ask all your questions : [forum.yunohost.org](https://forum.yunohost.org/c/support)

View file

@ -1,4 +1,4 @@
# <img src="/images/nextcloud-logo.png" alt="logo de Nextcloud"> Nextcloud
# <img src="/images/nextcloud_logo.png" alt="logo de Nextcloud"> Nextcloud
- [Découverte de l'environnement de Nextcloud](#EnvironnementNextcloud)
- [Logiciels Clients pour mobile et ordinateur](#LogicielsClients)
@ -7,21 +7,23 @@
- [Applications tiers](#AppsTiers)
- [Liens utiles](#liensutiles)
Nextcloud est un service d'hébergement de fichiers, de nombreuses applications peuvent être installés afin de lui offrir de nouvelles fonctionnalités tel que un agenda, un répertoire, des notes et pleins d'autres (vous pouvez trouver quelques applications dans la partie [applications tiers](#AppsTiers) mais il en existe pleins d'autres suivant vos besoins).
Nextcloud est un service d'hébergement de fichiers, de nombreuses applications peuvent être installées afin de lui offrir de nouvelles fonctionnalités tel qu'un agenda, un répertoire de contacts, des notes et pleins d'autres possibles (vous pouvez trouver quelques applications dans la partie [applications tiers](#AppsTiers) mais il en existe une multitude suivant vos besoins).
## <a name="EnvironnementNextcloud">Découverte de l'environnement de Nextcloud</a>
## Découverte de l'environnement de Nextcloud<a name="EnvironnementNextcloud"></a>
Du fait de la constitution de Nextcloud, une base avec des applications tiers à installer, cette découverte de nextcloud ne concernera que la base de nextcloud sans applications ajoutés. Plus d'informations sur les applications dans la partie dédiée ou sur le catalogue d'application de nextcloud : https://apps.nextcloud.com/
Du fait de la constitution de Nextcloud, une base avec des applications tiers à installer, ce chapitre ne concernera que la base de nextcloud sans applications ajoutés. Plus d'informations sur les applications dans la partie dédiée ou sur le catalogue d'application de nextcloud : [apps.nextcloud.com](https://apps.nextcloud.com).
Nextcloud est avant tout un service de cloud (comme Seafile et d'autres logiciels), il permet une synchronisation et le partage de fichiers sur internet et entre plusieurs terminaux (ordinateurs, smartphone) mais aussi avec plusieurs personnes.
## <a name="LogicielsClients">Logiciels Clients</a>
Il existe des logiciels client pour l'ensemble plateformes. Vous pouvez les retrouver sur le site officiel de nextcloud : https://nextcloud.com/install/#install-clients
## Logiciels Clients<a name="LogicielsClients"></a>
## <a name="ManipulationsUtiles"> Manipulations utiles & Problèmes rencontrés</a>
Il existe des logiciels clients pour de nombreux terminaux. Vous pouvez les retrouver sur le site de nextcloud : [nextcloud.com/install/#install-clients](https://nextcloud.com/install/#install-clients)
### <a name="AjoutEspace">Ajouter de l'espace à Nextcloud</a>
## Manipulations utiles & problèmes rencontrés<a name="ManipulationsUtiles"></a>
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.
### Ajouter de l'espace à Nextcloud<a name="AjoutEspace"></a>
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
@ -74,8 +76,7 @@ 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.
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
@ -156,39 +157,15 @@ Les options à désactiver (Off) sont :
Sauvegarder et nettoyer vos caches (Cloudflare, navigateur, ...) et le tour est joué.
## <a name="AppsTiers">Les applications Tiers</a>
## Applications Tiers<a name="AppsTiers"></a>
### L'application KeeWeb
+ [Calendrier](app_nextcloud_calendar_fr)
+ [contact](app_nextcloud_contact_fr)
+ [KeeWeb](app_nextcloud_keeweb_fr)
+ [Carnet](app_nextcloud_carnet_fr)
L'application KeeWeb est un gestionnaire de mots de passe incorporé à Nextcloud. Elle permet par exemple de lire un fichier de type KeePass (*.kdbx*) stocké sur votre instance Nextcloud.
Mais il arrive parfois que Nextcloud ne laisse pas l'application prendre en charge ces fichiers, ce qui rend alors impossible leur lecture de KeeWeb. Pour remédier à cela,
[une solution](https://github.com/jhass/nextcloud-keeweb/issues/34) existe.
## Quelques liens utiles<a name="liensutiles"></a>
Se rendre dans le répertoire de configuration de Nextcloud :
```bash
cd /var/www/nextcloud/config/
```
S'il n'existe pas, créer le fichier *mimetypemapping.json* dont le propriétaire est l'utilisateur *nextcloud* :
```bash
sudo su nextcloud -c "nano mimetypemapping.json"
```
Puis ajouter dans ce fichier le texte suivent :
```bash
{
"kdbx": ["x-application/kdbx"]
}
```
Enregistrer le fichier (**CTRL** + **o**) et quitter nano (**CTRL** + **c**).
A présent, le problème est corrigé.
## <a name="liensutiles">Quelques liens utiles</a>
+ Site officiel : [nextcloud.com (En anglais)](https://nextcloud.com/)
+ Site officiel : [nextcloud.com (en)](https://nextcloud.com/)
+ Catalogue d'application pour nextcloud : [apps.nextcloud.com](https://apps.nextcloud.com/)
+ Trouver de l'aide et poser toutes vos questions : [forum.yunohost.org](https://forum.yunohost.org/c/support)

29
app_nextcloud_keeweb.md Normal file
View file

@ -0,0 +1,29 @@
# The KeeWeb application
The KeeWeb application is a password manager integrated into Nextcloud. For example, it allows you to read a KeePass file (*.kdbx*) stored on your Nextcloud instance.
But sometimes Nextcloud does not let the application support these files, which makes it impossible to read them from KeeWeb. To remedy this,
[a solution](https://github.com/jhass/nextcloud-keeweb/issues/34) exists.
Go to the Nextcloud configuration directory:
```bash
cd /var/www/nextcloud/config/
```
If it does not exist, create the *mimetypemapping.json* file whose owner is the user *nextcloud* :
```bash
sudo su nextcloud -c "nano mimetypemapping.json"
```
Then add in this file the following text:
```bash
{
"kdbx": ["x-application/kdbx"]
}
```
Save the file (**CTRL** + **o**) and exit nano (**CTRL** + **c**).
Now the problem is fixed.

View file

@ -0,0 +1,38 @@
# L'application KeeWeb
L'application Keeweb sur le catalogue de nextcloud - [apps.nextcloud.com/keeweb](https://apps.nextcloud.com/apps/keeweb)
- [Manipulations utiles et problèmes rencontrés](#ManipulationsUtiles)
- [Liens utiles](#liensutiles)
L'application KeeWeb est un gestionnaire de mots de passe incorporé à Nextcloud. Elle permet par exemple de lire un fichier de type KeePass (*.kdbx*) stocké sur votre instance Nextcloud.
## Manipulations utiles & problèmes rencontrés <a name="ManipulationsUtiles"></a>
Mais il arrive parfois que Nextcloud ne laisse pas l'application prendre en charge ces fichiers, ce qui rend alors impossible leur lecture de KeeWeb. Pour remédier à cela,
[une solution](https://github.com/jhass/nextcloud-keeweb/issues/34) existe.
Se rendre dans le répertoire de configuration de Nextcloud :
```bash
cd /var/www/nextcloud/config/
```
S'il n'existe pas, créer le fichier *mimetypemapping.json* dont le propriétaire est l'utilisateur *nextcloud* :
```bash
sudo su nextcloud -c "nano mimetypemapping.json"
```
Puis ajouter dans ce fichier le texte suivent :
```bash
{
"kdbx": ["x-application/kdbx"]
}
```
Enregistrer le fichier (**CTRL** + **o**) et quitter nano (**CTRL** + **c**).
A présent, le problème est corrigé.
## Liens utiles <a name="liensutiles"></a>

View file

Before

Width:  |  Height:  |  Size: 5.9 KiB

After

Width:  |  Height:  |  Size: 5.9 KiB