Mise à jour de Nextcloud

Ce tutoriel décrit les étapes réalisées pour effectuer la mise à jour de Nextcloud incluant la création de sauvegardes, la mise à jour via la console, et le retour à un mode de fonctionnement normal.

Prérequis

  • Accès SSH à votre serveur Nextcloud

  • Nextcloud déjà installé

  • Droits sudo

Activez le mode maintenance 

sudo -u www-data php /var/www/nextcloud/occ maintenance:mode --on

1. Sauvegarde du dossier Nextcloud

Cette commande crée une copie du dossier Nextcloud avec la date du jour.

sudo rsync -Aax /var/www/nextcloud/ /var/www/nextcloud_backup_$(date +%F)

2. Sauvegarde de la base de données

Cette étape peut être ignorée si vous avez déjà des sauvegardes automatisées ou si vous êtes certain que la base est stable.

Si vous utilisez MariaDB ou MySQL avec le compte root

sudo mysqldump -u root -p nextcloud > ~/nextcloud_db_backup_$(date +%F).sql

Remplacez nextcloud par le nom de votre base de données si différent.

3. Lancement de l’outil de mise à jour

Allez dans le dossier Nextcloud

cd /var/www/nextcloud

Lancez l’outil.

sudo -u www-data php updater/updater.phar

Suivez les instructions à lécran. Exemple

  • [Y/n] pour continuer

  • Attendre que la sauvegarde et la mise à jour soient complétées

4. Mise à jour de la base

Le processus vous demandera d’exécuter la commande de mise à jour de la base de données. 

  • [Y/n] pour continuer

Ce processus

  • Met à jour le schéma de la base de données

  • Met à jour les apps compatibles

  • Effectue divers nettoyages (tags, caches, liens, etc.)

Si pour une raison obscure la question ne vous est pas posée la commande est la suivante.

sudo -u www-data php occ upgrade

5. Désactivation du mode maintenance

Si tout s’est bien passé vous devriez avoir l’option de désactiver le mode maintenance. Répondez [n] 

 

 

Si pour une raison obscure la question ne vous est pas posée la commande est la suivante.

sudo -u www-data php occ maintenance:mode --off

6. Post-mise à jour (optionnel)

Vérifiez dans votre navigateur que votre Nextcloud fonctionne.

Vous pouvez aussi relancer un scan des fichiers

sudo -u www-data php occ files:scan --all

Et supprimer la sauvegarde une fois tout validé.

 

Remplacez la date selon votre cas.

sudo rm -rf /var/www/nextcloud_backup_2025-07-11

Si vous revenez dans le panneau d’administration et vous voyez maintenant l’erreur suivante

Des indices facultatifs manquants ont été détectés. De nouveaux indices sont parfois ajoutés (par Nextcloud ou les applications installées) pour améliorer les performances de la base de données. L’ajout d’indices peut parfois prendre un certain temps et nuire temporairement aux performances. Cette opération n’est donc pas effectuée automatiquement lors des mises à niveau. Une fois les indices ajoutés, les requêtes sur ces tables devraient être plus rapides. Utilisez la commande occ db:add-missing-indices pour les ajouter. Index manquants : « unique_category_per_user » dans le tableau « vcategory » Pour plus d’information, voir la documentation ↗.

Pour la corriger nous allons nous déplacer dans le répertoire nextcloud 

cd /var/www/nextcloud/

Et lancer la commande suivante 

sudo -u www-data php occ db:add-missing-indices

Notes

Mise à jour testée sur Ubuntu 24.04 avec PHP 8.3


Pensez à mettre à jour vos paquets avec prudence (ex. php8.4) si vous utilisez des versions multiples

Scroll to Top