Votre site affiche “Briefly unavailable for scheduled maintenance” — et ça ne passe pas

Vous lancez une mise à jour WordPress — core, plugin, peu importe — et à mi-chemin la connexion coupe, le navigateur se ferme, l’hébergeur fait un timeout. Résultat : votre site reste figé sur ce message cryptique en anglais, visible par tous vos visiteurs, parfois depuis des heures.

Ce n’est pas un piratage. Ce n’est pas une corruption de base de données. C’est un fichier temporaire que WordPress n’a pas eu le temps de supprimer. La bonne nouvelle : ça se règle en moins de cinq minutes, sans toucher à la base de données ni réinstaller quoi que ce soit.


Pourquoi WordPress se coince en mode maintenance

Lors de chaque mise à jour, WordPress suit un protocole précis :

  1. Il crée un fichier .maintenance à la racine de votre installation.
  2. Ce fichier déclenche l’affichage du message de maintenance pour tous les visiteurs.
  3. Une fois la mise à jour terminée avec succès, WordPress supprime automatiquement ce fichier.
  4. Le site redevient accessible.

Le problème survient à l’étape 3 : si la mise à jour est interrompue (timeout serveur, connexion instable, conflit mémoire PHP, plugin qui plante à mi-chemin), le fichier .maintenance reste là. WordPress ne le supprime jamais parce qu’il n’a jamais atteint la fin du processus.

Causes fréquentes de l’interruption :

Sur un hébergement mutualisé d’entrée de gamme, les limites PHP par défaut peuvent être trop basses : memory_limit à 64M ou max_execution_time à 30 secondes suffisent à interrompre la mise à jour du core WordPress. Voir plus bas comment vérifier et ajuster ces valeurs.


Solution 1 — Supprimer le fichier .maintenance par FTP (méthode directe, 3 minutes)

C’est la méthode la plus rapide et la plus fiable.

Étape 1 : Se connecter à votre serveur en FTP

Ouvrez votre client FTP (FileZilla est le plus courant). Connectez-vous avec les identifiants fournis par votre hébergeur (hôte, identifiant, mot de passe, port 21 ou 22 pour SFTP).

Si vous n’avez jamais fait ça, votre hébergeur les stocke dans votre espace client sous “FTP” ou “Accès FTP”. Pour aller plus loin sur la connexion à votre serveur, l’article sur SSH et la connexion serveur détaille la logique d’accès à distance.

Étape 2 : Naviguer à la racine WordPress

Dans FileZilla, le panneau de droite affiche l’arborescence de votre serveur. Naviguez vers le dossier racine de WordPress : souvent public_html/, www/, ou un sous-dossier si WordPress est installé dans un répertoire spécifique.

Étape 3 : Afficher les fichiers cachés

Le fichier .maintenance commence par un point — il est donc masqué par défaut. Dans FileZilla : Serveur → Forcer l’affichage des fichiers cachés. Dans d’autres clients FTP, cherchez une option similaire (“Show hidden files”).

Étape 4 : Supprimer le fichier

Repérez le fichier .maintenance à la racine (au même niveau que wp-config.php et wp-login.php). Clic droit → Supprimer. C’est tout.

Rechargez votre site : il est de nouveau accessible. Connectez-vous à l’admin WordPress et vérifiez que la mise à jour s’est bien terminée — ou relancez-la proprement.


Solution 2 — Supprimer .maintenance via le gestionnaire de fichiers de l’hébergeur

Si vous n’avez pas de client FTP configuré, votre hébergeur propose presque toujours un gestionnaire de fichiers dans son panel de contrôle (cPanel, Plesk, DirectAdmin, interface propriétaire).

  1. Connectez-vous à votre espace hébergeur.
  2. Ouvrez “Gestionnaire de fichiers” ou “File Manager”.
  3. Activez l’affichage des fichiers cachés (option dans les préférences ou paramètres du gestionnaire).
  4. Naviguez à la racine WordPress.
  5. Supprimez le fichier .maintenance.

Sur Plesk, la navigation est légèrement différente — l’article SSH sur Plesk explique comment accéder à votre arborescence via ce panel.


Solution 3 — Supprimer .maintenance en ligne de commande (SSH)

Si vous avez accès SSH à votre serveur, c’est la méthode la plus rapide :

rm /var/www/html/.maintenance

Adaptez le chemin à votre installation. En cas de doute sur le chemin, utilisez :

find / -name ".maintenance" 2>/dev/null

Solution 4 — Vérifier et corriger les limites PHP pour éviter la récidive

Supprimer le fichier règle le symptôme. Si la mise à jour a échoué faute de ressources, le problème reviendra à la prochaine mise à jour. Voici les directives PHP à vérifier :

DirectiveRôleSymptôme si trop basseValeur conseillée
memory_limitRAM allouée à PHP pour exécuter le scriptMise à jour qui plante à mi-chemin, erreur “fatal error: allowed memory size exhausted”256M minimum
max_execution_timeTemps max d’exécution d’un script PHP (en secondes)Timeout pendant le téléchargement ou l’installation d’une grosse mise à jour300 (5 minutes)
max_input_timeTemps max pour recevoir les données d’entréeTimeout sur upload de fichiers lourds lors d’une mise à jour300
post_max_sizeTaille max des données POSTEmpêche le téléversement de paquets de mise à jour volumineux64M

Où modifier ces valeurs :

Via wp-config.php (solution partielle, uniquement pour memory_limit) :

define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '512M');

Via .htaccess (sur serveurs Apache) :

php_value memory_limit 256M
php_value max_execution_time 300

Via php.ini (si votre hébergeur le permet) :

memory_limit = 256M
max_execution_time = 300

Via le panel hébergeur : la plupart des hébergeurs modernes (OVH, Ionos, o2switch, Infomaniak) permettent de modifier ces valeurs directement dans l’interface, sans toucher aux fichiers. C’est la méthode recommandée si vous n’êtes pas à l’aise avec FTP.


Solution 5 — Vérifier que la mise à jour s’est bien terminée

Une fois le fichier .maintenance supprimé, ne considérez pas l’affaire classée sans vérifier l’état réel de WordPress :

  1. Connectez-vous à /wp-admin/.
  2. Allez dans Tableau de bord → Mises à jour.
  3. Si une mise à jour est toujours listée comme disponible, relancez-la maintenant que les limites PHP sont correctes.
  4. Vérifiez les plugins un par un dans Extensions : un plugin à moitié mis à jour peut provoquer des comportements erratiques. En cas de plugin problématique après une MAJ, consultez l’article sur le rollback propre d’un plugin cassé.

Si le site s’affiche mais génère des erreurs PHP visibles ou une page blanche après la suppression du fichier, le problème est plus profond — potentiellement un conflit de plugin ou une erreur critique WordPress, que l’article sur l’erreur critique WordPress couvre en détail.


Éviter que ça recommence

Quelques ajustements simples pour que la prochaine mise à jour se passe sans accroc :


Le fichier .maintenance est absent mais le message persiste. Pourquoi ?

Votre hébergeur ou un plugin de mise en cache sert une version en cache de la page de maintenance. Videz le cache côté serveur (dans l’interface de votre hébergeur ou via votre plugin de cache : W3 Total Cache, WP Super Cache, LiteSpeed Cache) et effacez le cache de votre navigateur avec Ctrl+Shift+R.

Puis-je créer un fichier .maintenance volontairement pour afficher une page de maintenance ?

Oui. Un fichier .maintenance vide à la racine déclenche le message par défaut de WordPress. Pour une vraie page de maintenance personnalisée, utilisez plutôt un plugin dédié (SeedProd, WP Maintenance Mode) qui vous donne le contrôle sur le design et les exceptions (votre propre IP peut rester hors maintenance).

La suppression du fichier .maintenance a fonctionné mais WooCommerce affiche des erreurs. Que faire ?

La mise à jour WooCommerce a probablement été interrompue à mi-chemin. Allez dans WooCommerce → État → Outils et lancez “Mettre à jour la base de données WooCommerce”. Si les erreurs persistent, désactivez puis réactivez WooCommerce depuis la liste des plugins pour forcer une réinitialisation de ses hooks.

Mon hébergeur n'affiche pas les fichiers cachés dans son gestionnaire de fichiers. Que faire ?

Cherchez dans les préférences ou paramètres du gestionnaire une case “Afficher les fichiers cachés” ou “Show dotfiles”. Sur cPanel, c’est dans Settings en haut à droite du File Manager. Si vraiment introuvable, passez par FTP avec FileZilla (option Serveur → Forcer l’affichage des fichiers cachés) ou par SSH si votre hébergement le permet.

Quand faut-il passer la main à un professionnel ?

Si après suppression du fichier .maintenance votre site reste cassé — page blanche, erreur 500, admin inaccessible — le problème n’est plus le fichier de maintenance mais une corruption plus profonde : mise à jour partielle de la base de données, incompatibilité de plugin, ou limite mémoire tellement basse que WordPress ne peut pas démarrer. C’est le moment de faire appel à quelqu’un. Un contrat de maintenance avec intervention illimitée évite de payer chaque intervention à la pièce dans ces moments-là.

Ce problème, Peechy s'en occupe

Plutôt que de tout gérer seul, confiez votre site à une agence qui s'occupe de tout — hébergement, sécurité, maintenance et corrections. Encore plus simple en abonnement : on règle les soucis avant même que vous les remarquiez.

Confier mon site à Peechy