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.
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 -u www-data php /var/www/nextcloud/occ maintenance: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
Remplacez nextcloud par le nom de votre base de données si différent.
sudo mysqldump -u root -p nextcloud > ~/nextcloud_db_backup_$(date +%F).sql
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
Voilà votre instance de Nextcloud est à jour.