Votre instance affiche un écran de maintenance, ou vous devez bloquer les connexions avant une intervention ? En 2026, le mode maintenance Nextcloud se pilote de préférence avec la commande occ maintenance:mode. Il verrouille les sessions actives, empêche les utilisateurs d’accéder au service et présente une page d’information temporaire.
La commande est courte, mais une désactivation trop rapide peut rouvrir une base non mise à niveau ou une opération inachevée. Ce tutoriel explique quand activer le mode, quelle syntaxe employer selon l’installation, comment lire occ status et comment reprendre proprement une mise à jour interrompue.
À quoi sert le mode maintenance Nextcloud ?
Le manuel officiel des commandes système réserve ce mode aux opérations qui exigent l’absence d’activité utilisateur. Nextcloud ferme les sessions, y compris celles des administrateurs, puis affiche un écran de statut. Les commandes intégrées au serveur restent accessibles en ligne de commande.
Ce verrouillage est utile lorsqu’une intervention doit conserver un état cohérent entre la base, la configuration et les fichiers. C’est notamment le cas pendant certaines sauvegardes, restaurations, migrations ou mises à niveau. Le guide de sauvegarde Nextcloud montre comment l’insérer dans une copie cohérente, tandis que le tutoriel pour migrer Nextcloud vers un nouveau serveur l’intègre à une bascule complète.
Le mode maintenance ne remplace toutefois ni une sauvegarde, ni l’arrêt d’un service externe, ni un plan de retour arrière. Si vous modifiez le stockage, la base, Redis ou un proxy, vous devez aussi contrôler chaque composant concerné. Le guide complet de Nextcloud permet de replacer ces dépendances dans l’architecture générale.
Ne confondez pas deux réglages différents
maintenance:mode rend l’instance indisponible aux utilisateurs. Le paramètre maintenance_window_start ne ferme pas le service : en mode cron, il réserve une fenêtre UTC de quatre heures à certaines tâches de fond non urgentes. Il ne permet donc pas de préparer une sauvegarde ou une migration.
Que vérifier avant de bloquer les utilisateurs ?
Commencez par identifier la méthode d’installation. Une archive installée dans /var/www/nextcloud, l’image Docker officielle, All-in-One et le paquet Snap n’exposent pas occ de la même façon. Copier une commande sans adapter le chemin, le compte HTTP ou le nom du conteneur produit souvent un refus de permission ou un fichier introuvable.
Préparez ensuite une fenêtre d’intervention mesurable :
- informez les utilisateurs de l’heure de début et du service concerné ;
- confirmez que la sauvegarde attendue existe et qu’elle se restaure ;
- notez la version actuelle avec
occ status; - vérifiez l’espace libre sur le système, les données et la base ;
- gardez un accès administrateur indépendant du navigateur ;
- définissez les contrôles à réussir avant la réouverture.
Sur une installation Linux classique, exécutez occ avec le compte du serveur web, souvent www-data sur Debian ou Ubuntu. N’utilisez pas directement root si les fichiers appartiennent au compte HTTP : certaines commandes pourraient créer des fichiers avec un propriétaire incorrect.
cd /var/www/nextcloud
sudo -E -u www-data php occ status
La sortie doit indiquer au minimum que l’instance est installée, sa version, l’état maintenance et la valeur needsDbUpgrade. Conservez cette première lecture afin de la comparer à celle obtenue après l’intervention.
Comment activer le mode maintenance avec occ, Docker ou Snap ?
Pour une installation par archive, placez-vous dans le répertoire Nextcloud ou indiquez le chemin absolu de occ :
sudo -E -u www-data php /var/www/nextcloud/occ maintenance:mode --on
Le serveur doit répondre Maintenance mode enabled. Vérifiez immédiatement l’état au lieu de vous fier uniquement au message de la commande :
sudo -E -u www-data php /var/www/nextcloud/occ status
La syntaxe change avec le conditionnement du logiciel. Les exemples suivants viennent des dépôts officiels des images concernées :
| Installation | Commande d’activation |
|---|---|
| Archive Linux | sudo -E -u www-data php /var/www/nextcloud/occ maintenance:mode --on |
| Image Docker officielle | docker exec --user www-data CONTENEUR php occ maintenance:mode --on |
| Docker Compose officiel | docker compose exec --user www-data app php occ maintenance:mode --on |
| Nextcloud All-in-One | sudo docker exec --user www-data nextcloud-aio-nextcloud php occ maintenance:mode --on |
| Paquet Snap | sudo nextcloud.occ maintenance:mode --on |
Remplacez CONTENEUR par le nom ou l’identifiant réel. Dans Compose, app est le nom de service utilisé par l’exemple officiel, pas une valeur universelle. Pour Snap, /snap/bin/nextcloud.occ peut être nécessaire si /snap/bin n’est pas présent dans le PATH.
Ouvrez ensuite l’URL depuis une fenêtre privée. Vous devez voir la page de maintenance plutôt que l’interface de connexion. Gardez votre terminal ouvert : le navigateur ne permet plus de revenir dans l’administration tant que le verrouillage est actif.
Comment contrôler l’état pendant l’intervention ?
occ status fournit une lecture humaine. L’option -e renvoie plutôt un code exploitable par un script ou une supervision, sans texte par défaut :
sudo -E -u www-data php /var/www/nextcloud/occ status -e
echo $?
| Code | Signification documentée | Action attendue |
|---|---|---|
0 | fonctionnement normal | poursuivre les contrôles de service |
1 | mode maintenance actif | terminer l’intervention avant de rouvrir |
2 | occ upgrade requis | achever la mise à niveau de la base |
Cette distinction évite une erreur fréquente : croire qu’une instance est simplement verrouillée alors que son code et sa base n’ont pas encore atteint le même niveau. Un code 2 demande un diagnostic de mise à niveau, pas seulement maintenance:mode --off.
Pendant l’opération, consignez les commandes exécutées et leurs codes de retour. Si vous copiez des données, contrôlez le résultat de la copie. Si vous intervenez sur la base, vérifiez que la transaction, l’import ou la migration est terminé. Si un service a été arrêté, relancez-le avant la recette. Le mode maintenance ne confirme aucune de ces étapes à votre place.
Comment désactiver le mode maintenance sans rouvrir trop tôt ?
Avant la désactivation, vérifiez que l’opération principale est terminée, que la base répond, que les volumes sont montés et que les permissions n’ont pas changé. Relancez aussi les services nécessaires, par exemple PHP-FPM, le serveur web, Redis ou le conteneur applicatif, selon votre architecture.
Sur une installation par archive :
sudo -E -u www-data php /var/www/nextcloud/occ maintenance:mode --off
sudo -E -u www-data php /var/www/nextcloud/occ status
Pour Docker, All-in-One ou Snap, reprenez la commande d’activation correspondante et remplacez --on par --off. La sortie finale doit afficher maintenance: false et needsDbUpgrade: false. Si needsDbUpgrade reste vrai, ne validez pas la remise en service.
Effectuez ensuite une recette courte avec un compte de test : connexion, ouverture d’un fichier, envoi d’un petit document, création puis suppression d’un partage et synchronisation depuis un client si elle est utilisée. Contrôlez les journaux Nextcloud et ceux du serveur web pendant ces essais. Pour une instance collaborative, testez aussi les applications réellement utilisées, comme Calendar, Contacts, Talk ou la suite bureautique.
Réactivez enfin les tâches cron si elles avaient été suspendues. Une interface accessible ne prouve pas que les tâches d’arrière-plan, les notifications, les nettoyages et les traitements différés ont repris.
Que faire si Nextcloud reste bloqué après une mise à jour ?
Une mise à jour web peut dépasser le délai PHP et laisser l’instance verrouillée. La procédure officielle de mise à niveau manuelle recommande alors d’arrêter le processus bloqué, de désactiver le mode maintenance, puis de lancer la mise à niveau avec occ :
cd /var/www/nextcloud
sudo -E -u www-data php occ maintenance:mode --off
sudo -E -u www-data php occ upgrade
sudo -E -u www-data php occ status
Cette séquence concerne une mise à jour dont le nouveau code est déjà en place. Si les fichiers du programme n’ont pas été remplacés correctement, occ upgrade ne peut pas inventer la version manquante. Reprenez alors la méthode de mise à jour correspondant à votre installation, avec une sauvegarde récente et les prérequis de la version cible.
Si la commande d’upgrade échoue encore, la documentation propose ensuite occ maintenance:repair. Cette commande exécute des étapes de réparation ; elle ne signifie pas « quitter le mode maintenance » et ne remplace pas l’analyse du premier message d’erreur.
sudo -E -u www-data php occ maintenance:repair
Lisez le journal Nextcloud avant de répéter les commandes. Cherchez la première erreur liée à la base, au stockage, à une application ou à une permission. Désactiver le verrouillage sans corriger cette cause peut transformer une indisponibilité contrôlée en erreurs visibles par tous les utilisateurs.
Évitez de modifier config.php en premier recours
La clé maintenance existe dans la configuration, mais occ maintenance:mode reste préférable. Les installations Docker peuvent fusionner plusieurs fichiers de configuration et des variables d’environnement. Utilisez occ config:list system pour lire la configuration effective plutôt que de supposer qu’un seul fichier contient toute la vérité.
Quelles erreurs éviter lors d’une maintenance Nextcloud ?
La première erreur consiste à verrouiller l’instance sans terminal de secours. Testez la commande occ, le compte système et le chemin avant la fenêtre annoncée. La deuxième est d’oublier les clients de synchronisation : laissez-leur le temps de recevoir l’état de maintenance avant une opération longue, surtout lors d’une migration.
Évitez aussi ces raccourcis :
- activer le mode sans sauvegarde adaptée à l’opération ;
- modifier les fichiers avec
root, puis laisser des propriétaires incohérents ; - rouvrir le service alors que
occ status -erenvoie2; - prendre
maintenance_window_startpour un verrouillage des utilisateurs ; - lancer
maintenance:repairsans lire l’erreur initiale ; - oublier de réactiver cron et la supervision ;
- considérer la page de connexion comme une recette suffisante.
Après une intervention sur le stockage, ne lancez pas automatiquement un scan global. Le tutoriel Nextcloud files:scan explique quand cibler un utilisateur ou un chemin et pourquoi --all ne répare pas une base, un montage ou des permissions défaillantes.
Conclusion
Le mode maintenance Nextcloud doit encadrer une opération précise : contrôler l’état initial, verrouiller les accès avec la commande adaptée, réaliser l’intervention, vérifier la base et les services, puis rouvrir et tester. occ status -e permet de distinguer un verrouillage normal d’une mise à niveau encore requise. Si l’instance reste bloquée, suivez la séquence officielle d’upgrade et de réparation au lieu de forcer l’accès. Une offre gérée évite enfin d’administrer directement ces opérations système.