Nextcloud : mode maintenance et mises à jour avec occ

Le mode maintenance bloque l’accès des utilisateurs pendant les opérations sensibles.

Prérequis

• Accès shell en tant que www-data.
• Sauvegarde de la base de données et du dossier config réalisée.
• Racine Nextcloud : /var/www/nextcloud.

Activer le mode maintenance

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

Lancer la procédure de mise à jour

sudo -u www-data php occ upgrade

Réparer l’instance

sudo -u www-data php occ maintenance:repair --include-expensive

Ajouter les index de base manquants

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

Désactiver le mode maintenance

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

Vérification

sudo -u www-data php occ status

La sortie indique maintenance: false et la version active.

Dépannage

• Instance bloquée en maintenance : éditer config.php et passer 'maintenance' => false.
• Mise à jour interrompue : relancer occ upgrade après correction de l’erreur dans nextcloud.log.
• « Cannot write into config directory » : corriger les droits avec chown -R www-data:www-data config/.
• Tâches de réparation longues : exécuter en dehors des heures de production.