Nextcloud : dépanner la synchronisation du client de bureau

Cette procédure isole les causes d’un blocage de synchronisation du client de bureau Nextcloud.

Prérequis

• Client de bureau Nextcloud installé.
• Accès aux journaux du client.

Étapes de diagnostic

1. Ouvrir le client, onglet « Activité », vérifier les erreurs et fichiers en échec.
2. Activer le journal détaillé : menu « … » > « Paramètres » > « Général » > « Journal de débogage ».
3. Localiser le fichier de log :

ls ~/.config/Nextcloud/logs/

4. Rechercher les erreurs HTTP :

grep -iE "error|403|423|507" ~/.config/Nextcloud/logs/*.log

Causes fréquentes et corrections

• Caractères interdits dans un nom de fichier : renommer le fichier (\ / : * ? " < > |).
• Fichier verrouillé (423) : attendre la fin d’un autre transfert ou lever le verrou côté serveur.
• Quota dépassé (507) : libérer de l’espace ou augmenter le quota.
• Conflit : ouvrir les fichiers *_conflict-*, fusionner puis supprimer le doublon.

Forcer une resynchronisation

1. Fermer le client.
2. Supprimer la base de synchronisation locale :

rm ~/Nextcloud/.sync_*.db

3. Relancer le client : il recompare l’arborescence locale et distante.

Vérification

• L’onglet « Activité » n’affiche plus d’élément en échec.
• L’icône de la barre des tâches affiche une coche verte.

Dépannage

• Synchronisation figée : redémarrer le client et vérifier l’accès au serveur (curl -I https://cloud.exemple.fr).
• Authentification expirée : retirer et réajouter le compte avec un mot de passe d’application.
• Horloge désynchronisée : corriger l’heure système, les jetons OAuth en dépendent.
• Dossier non synchronisé : vérifier qu’il est coché dans la sélection de dossiers.