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 :
- Il crée un fichier
.maintenanceà la racine de votre installation. - Ce fichier déclenche l’affichage du message de maintenance pour tous les visiteurs.
- Une fois la mise à jour terminée avec succès, WordPress supprime automatiquement ce fichier.
- 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 :
- Timeout serveur pendant le téléchargement d’une grosse mise à jour (core WordPress, WooCommerce)
- Mémoire PHP insuffisante — la mise à jour plante faute de ressources
- Connexion internet coupée côté admin pendant la procédure
- Plusieurs mises à jour lancées simultanément (WordPress les traite en séquence, pas en parallèle)
- Hébergement mutualisé avec des limites agressives sur
max_execution_time - Plugin de sécurité ou pare-feu qui bloque le processus en cours de route
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).
- Connectez-vous à votre espace hébergeur.
- Ouvrez “Gestionnaire de fichiers” ou “File Manager”.
- Activez l’affichage des fichiers cachés (option dans les préférences ou paramètres du gestionnaire).
- Naviguez à la racine WordPress.
- 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 :
| Directive | Rôle | Symptôme si trop basse | Valeur conseillée |
|---|---|---|---|
memory_limit | RAM allouée à PHP pour exécuter le script | Mise à jour qui plante à mi-chemin, erreur “fatal error: allowed memory size exhausted” | 256M minimum |
max_execution_time | Temps max d’exécution d’un script PHP (en secondes) | Timeout pendant le téléchargement ou l’installation d’une grosse mise à jour | 300 (5 minutes) |
max_input_time | Temps max pour recevoir les données d’entrée | Timeout sur upload de fichiers lourds lors d’une mise à jour | 300 |
post_max_size | Taille max des données POST | Empêche le téléversement de paquets de mise à jour volumineux | 64M |
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 :
- Connectez-vous à
/wp-admin/. - Allez dans Tableau de bord → Mises à jour.
- Si une mise à jour est toujours listée comme disponible, relancez-la maintenant que les limites PHP sont correctes.
- 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 :
- Mettre à jour depuis un réseau stable : pas depuis un café en 4G, pas depuis un VPN capricieux.
- Désactiver temporairement les plugins de sécurité agressifs (Wordfence, iThemes Security) avant une mise à jour majeure du core — ils peuvent interférer.
- Mettre à jour un plugin à la fois, pas tout d’un coup. WordPress gère les mises à jour en séquence, mais une erreur sur l’une peut corrompre le fichier
.maintenance. - Avoir une vraie maintenance régulière : une mise à jour ratée sur un site sans sauvegarde récente, c’est potentiellement des heures de récupération. La maintenance d’un site web en 2026 n’est pas optionnelle.
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