wiki/HowtoNextCloud.md
2021-11-26 16:04:47 +01:00

143 lines
6.3 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
categories: web
title: Howto NextCloud
...
[NextCloud](https://docs.nextcloud.com/) est un logiciel libre qui permet de stocker des fichiers sur un serveur distant, communément appelé un « cloud ».
Ses fonctionnalités étendues et les nombreux plugins (nommés « Apps ») disponibles font de Nextcloud une plateforme collaborative très modulaire et une alternative libre remarquable face aux logiciels privateurs comme ~~Google Docs~~, ~~Google Drive~~ ou ~~Dropbox~~.
On y trouve, entre autres, des fonctionnalités essentielles comme le partage de fichiers (même à des utilisateurs non connectés), l'édition collaborative, la gestion de droits, un calendrier, un agenda...
Documentation Nextcloud officielle : <https://docs.nextcloud.com/>
# Côté client
## Utilisation
Les fichiers stockés sont accessibles :
* Via une interface web accessible à partir de n'importe quel navigateur (depuis un PC ou un smartphone) ;
* Via le [protocole WebDAV](https://fr.wikipedia.org/wiki/WebDAV) ;
* Via un connecteur de synchronisation disponible sur Linux, Mac et Windows ;
* Via une application [Android](https://nextcloud.fr.aptoide.com/app) ou [iPhone](https://apps.apple.com/fr/app/nextcloud/id1125420102).
### Sur Debian
#### Synchronisation automatique : nextcloud-desktop
Pour synchroniser automatiquement vos fichiers entre votre ordinateur et votre instance Nextcloud, il faut installer le paquet Debian [nextcloud-desktop](https://packages.debian.org/stable/nextcloud-desktop).
Le programme s'exécute en tâche de fond et ajoute une icône dans la barre des tâches, à partir de laquelle on peut le configurer.
S'il n'est pas visible dans la barre des tâches, il faut le lancer manuellement (Menu > Accessoires > Client de synchronisation Nextcloud) et vérifier dans ses paramètres que l'option "Lancer au démarrage du système" est bien cochée.
S'il ne démarre pas automatiquement au prochain redémarrage, vous devez l'ajouter manuellement aux applications démarrées automatiquement par votre environnement de bureau (KDE, Gnome, XFCE...).
Par exemple, pour XFCE :
* `Menu > Paramètres > Session et démarrage > Démarrage automatique d'application > +`
* Commande à exécuter : `/usr/bin/nextcloud --background`
#### Intégration aux gestionnaires de fichiers
**Todo :**
* _WebDAV : davs://nextcloud.evolix.org/remote.php/dav/files/$login + _
* _non obligatoire si section précédente_
Des paquets Debian suivants sont disponibles pour l'intégration dans différents gestionnaires de fichiers :
* [Gnome] Nautilus : [nautilus-nextcloud](https://packages.debian.org/stable/nautilus-nextcloud)
* [KDE] Dolphin : [dolphin-nextcloud](https://packages.debian.org/stable/dolphin-nextcloud)
* [Cinnamon, Unity] Nemo : [nemo-nextcloud](https://packages.debian.org/stable/nemo-nextcloud)
* [Mate] Caja : [caja-nextcloud](https://packages.debian.org/stable/caja-nextcloud)
## Administration
### Gestion des droits
Le plugin "Group folders" permet de créer des partages via les paramètres d'admininistration, puis de mettre des droits pour des utilisateur.trice.s et les groupes.
Pour gérer proprement les partages, il est préférable de gérer les droits par groupe que par utilisateur.trice.s.
Sans ce plugin, un.e utilisateur.trice peut créer un répertoire et le partager avec certains droits. Cependant, ce n'est pas pratique : iel peut retirer les droits, ou on peut être embêté.e si l'on doit supprimer l'utilisateur.trice dans le futur.
Page du plugin : <https://apps.nextcloud.com/apps/groupfolders>
### Mise-à-jour
Dans Nextcloud, les mises-à-jour se font de version en version. S'il y a plusieurs versions de retard, il faut le mettre à jour autant de fois qu'il y a de versions de retard.
Les mises-à-jour peuvent être faites par l'adminsitrateur.trice via l'interface web.
Pour cela : cliquez sur le bouton rond en haut à droite > Paramètres > Vue d'ensemble > Ouvrir le système de mise-à-jour.
Puis suivez les instructions.
Attention, il ne faut pas fermer la page pendant la mise-à-jour, sinon vous resterez bloqué.e en mode maintenance.
A la fin des opérations de mise-à-jour, l'interface propose de quitter le mode maintenance.
En cas d'oubli, votre interface web sera [bloquée en mode maintenance](HowtoNextCloud#interface-web-bloquee-en-mode-maintenance).
## Dépannage
### Interface web bloquée en mode maintenance
C'est une erreur très courante et anodine. Elle se produit lorsque, à la fin d'une mise-à-jour effectuée via l'interface web, on sélectionne (par oubli ou par erreur) "rester en mode maintenance".
Pour sortir du mode maintenance par la suite, il faut faire appel à votre administrateur.trice système qui a un accès au serveur en ligne de commande, et qui va suivre [la procédure ci-dessous](HowtoNextCloud#interface-web-bloquée-en-mode-maintenance-1)
# Côté serveur
Chez Evolix, notre offre [NextCloud SAAS](https://evolix.com/offres-saas.html) fonctionne sur le serveur web Nginx, le serveur de base de données MariaDB et le serveur de cache Redis.
## Installation
Evolix met à votre disposition dans son dépôt public [ansible-roles](https://gitea.evolix.org/evolix/ansible-roles>) un rôle Ansible pour installer automatiquement Nextcloud !
Si vous êtes intéressé.e par d'autres méthodes d'installation :
* Documentation d'installation officielle : <https://docs.nextcloud.com/server/latest/admin_manual/installation>.
* La dernière version peut être téléchargée sur <https://download.nextcloud.com/server/releases/>.
## Administration via l'utilitaire `occ` en ligne de commande
NextCloud propose un utilitaire en ligne de commande très bien conçu et nommé `occ`.
Pour l'utiliser, il faut se logger en tant que l'utilisateur de l'instance Nextcloud à administrer, puis se déplacer dans le répertoire de l'instance.
L'utilitaire est écrit en PHP, il exécute donc de la manière suivante, par exemple pour obtenir la liste des commandes :
```
php occ
```
### Interface web bloquée en mode maintenance
C'est une erreur très courante et anodine, lorsque l'on oublie ou que l'on se trompe lors de la dernière étape de la mise-à-jour via l'interface web.
Pour être sûr.e que la mise-à-jour s'est bien déroulée, on peut la relancer :
```
php occ upgrade
```
Puis, on sort du mode maintenance :
```
php occ maintenance:mode --off
```