Wanneer je deze melding ziet, WordPress website tijdelijk niet beschikbaar vanwege gepland onderhoud, vraag je je misschien af wat er precies aan de hand is. Meestal is het geen ernstige fout, maar gewoon een teken dat WordPress zelf bezig is met een update. In dit artikel lees je in eenvoudige woorden waarom dit gebeurt, wat het betekent en hoe je het snel kunt oplossen.
Wat is de onderhoudsmodus in WordPress precies?
Tijdens het updaten van WordPress of een plugin zet WordPress je site heel even in onderhoudsmodus. Dat doet het systeem door een klein tijdelijk bestand aan te maken in de hoofdmap van je installatie, het .maintenance bestand. Zodra de update klaar is, hoort dit bestand automatisch te verdwijnen. Blijft het staan, dan blijft de melding zichtbaar en lijkt je website niet bereikbaar.
Waarom verschijnt deze melding op mijn site?
Er zijn meerdere oorzaken. Denk aan een verbroken verbinding met de server tijdens het downloaden van bestanden, een conflict met een caching plugin, te weinig serverresources, of een time out bij het updaten. Ook kan een plugin update mislukt zijn of is de hosting even traag.
Het resultaat is hetzelfde, het .maintenance bestand blijft liggen en de onderhoudsmelding blijft in beeld. In het Engels zie je vaak de tekst Briefly unavailable for scheduled maintenance. Check back in a minute.
Heb je het idee dat een plugin update vastloopt of dat installeren niet lukt, lees dan ook, Wat te doen als je geen WordPress plugin installeren kunt.
Hoe ziet het er technisch uit onder de motorkap?
Wanneer je op Updaten klikt, maakt WordPress in de map public_html, of in de map waar WordPress staat, het .maintenance bestand aan. Terwijl dit gebeurt, laat WordPress bezoekers weten dat de site bezig is met gepland onderhoud. Na een succesvolle update wordt het bestand weer verwijderd. Gaat er iets mis, dan moet je dit bestand zelf weghalen via de bestandsbeheerder van je hosting.
Krijg je de melding dat er al een andere update actief is, bekijk de uitleg in, WordPress foutmelding: Er is momenteel een andere update in uitvoering.
Methode 1: Controleer en verwijder het .maintenance bestand
Het .maintenance bestand verwijderen in cPanel
In dit deel leggen we uit hoe je het probleem oplost via cPanel en DirectAdmin. Gebruik je een andere beheeromgeving of een speciaal hostingpaneel, dan is de werkwijze vrijwel hetzelfde. Alleen de plaats van sommige knoppen of tabbladen kan iets verschillen.
- Log in op cPanel van je hosting.
- Ga naar Files en open File Manager.
- Navigeer naar public_html, of naar de map waar WordPress is geïnstalleerd, bijvoorbeeld bij een subdomein of submap.
- Zoek naar het bestand .maintenance. Zie je het niet, klik rechtsboven op Settings, vink Show hidden files aan, klik op Save.
- Klik met de rechtermuisknop op .maintenance en kies Delete.
- Bevestig met Confirm. Laad je website opnieuw, de melding hoort direct weg te zijn.
Het .maintenance bestand verwijderen in DirectAdmin
Gebruik je DirectAdmin in plaats van cPanel, dan werkt het vrijwel hetzelfde.
- Log in op DirectAdmin.
- Ga naar System Info & Files en open File Manager.
- Ga naar public_html, of de map waar WordPress staat.
- Zoek het .maintenance bestand en verwijder het. Vernieuw je website, de foutmelding is als het goed is weg.
Bekijk dit Engelstalige artikel op WPBeginner. Daar vind je stap-voor-stap instructies en aanvullende oplossingen voor hetzelfde probleem. Lees het artikel op WPBeginner
Methode 2: Controleer wp-activate.php als de melding blijft
Blijft de melding zichtbaar, ook nadat je .maintenance hebt verwijderd, controleer dan dit bestand en deze constante.
- Open in de hoofdmap van je WordPress installatie het bestand wp-activate.php via File Manager, kies Edit.
- Zoek naar de volgende regel. Staat er true, zet het op false.
define('WP_INSTALLING', true);Verander naar:
define('WP_INSTALLING', false);- Sla op en test je website opnieuw. In de meeste gevallen is de onderhoudsmodus nu weg.
Wil je achterhalen welke fout precies speelt, zet tijdelijk debugging aan met de stappen uit, Handleiding WordPress debugging inschakelen stap voor stap.
Je eigen onderhoudspagina tonen met maintenance.php, netjes en duidelijk
Wil je bezoekers een nette pagina laten zien terwijl de update draait, maak dan een eigen maintenance.php aan. Dit doe je door in de map wp-content een nieuw bestand aan te maken met de naam maintenance.php. Je kunt dit direct in de File Manager doen door te klikken op New File, en vervolgens maintenance.php in te voeren.
Plaats het bestand in de hoofdmap van wp-content, dus op hetzelfde niveau als de mappen plugins, themes en uploads. Voeg daarna de onderstaande code toe aan dit bestand en sla het op. Zodra WordPress de onderhoudsmodus activeert, toont het automatisch deze pagina aan je bezoekers.
<?php
$protocol = $_SERVER["SERVER_PROTOCOL"];
if ('HTTP/1.1' != $protocol && 'HTTP/1.0' != $protocol) {
$protocol = 'HTTP/1.0';
}
header("$protocol 503 Service Unavailable", true, 503);
header('Content-Type: text/html; charset=utf-8');
?>
<html xmlns="http://www.w3.org/1999/xhtml">
<body>
<h1>We werken aan een update, kom over een paar minuten terug, bedankt voor je geduld.</h1>
</body>
</html>
<?php die(); ?>Tip: Geef deze pagina wat stijl met eenvoudige CSS, zo blijft de ervaring prettig, ook tijdens onderhoud.
Wanneer is het een goed idee om nog even te wachten, en wanneer niet?
Als je net een update startte en je ziet kort de melding, wacht dan een minuut en vernieuw de pagina. Is de melding langer zichtbaar, bijvoorbeeld vijf tot tien minuten, controleer dan direct het .maintenance bestand. Zeker bij grotere updates of trage hosting kan het proces even duren, maar urenlang zichtbaar blijven is niet normaal.
Veelvoorkomende oorzaken op een rij, en hoe je ze voorkomt
• Plugin update mislukt door netwerkproblemen, probeer de update later opnieuw.
• Conflict met caching plugin, leeg de cache of schakel de plugin tijdelijk uit.
• Te weinig schijfruimte of limieten op de server, controleer je hosting en verhoog waar nodig.
• Time out tijdens het downloaden, probeer de update plugin voor plugin in plaats van alles tegelijk.
• Onvolledige update van het WordPress core pakket, voer de update handmatig opnieuw uit via Dashboard, Updates.
• Verborgen bestanden niet zichtbaar, dit betekent dat het .maintenance bestand verborgen kan zijn in je bestandsbeheer. Klik rechtsboven in de File Manager op Settings en vink ‘Show hidden files’ aan om het bestand te zien en te verwijderen.
• Verkeerde map gecontroleerd, soms kijk je in de verkeerde map, bijvoorbeeld alleen in public_html terwijl je WordPress in een submap zoals /blog of /site hebt geïnstalleerd. Ga in dat geval naar de juiste map en controleer daar opnieuw op het .maintenance bestand.
Is traagheid of een time out de oorzaak, optimaliseer je site met de tips uit, WordPress website sneller maken: 23 bewezen methodes.
Conclusie
In de meeste gevallen is dit snel op te lossen. Verwijder het .maintenance bestand via cPanel of DirectAdmin, en controleer desnoods de waarde van WP_INSTALLING in wp-activate.php. Wil je het netter presenteren, maak dan een eigen maintenance.php in wp-content aan. Met deze stappen is je website meestal binnen enkele minuten weer zichtbaar.
Veelgestelde vragen
1. Kan ik voorkomen dat dit opnieuw gebeurt?
Ja, door updates één voor één uit te voeren, eerst een back-up te maken en regelmatig je plugins en thema’s op te schonen. Gebruik daarnaast een betrouwbare hostingprovider met voldoende resources.
2. Ik heb .maintenance verwijderd, maar de melding blijft, wat nu?
Controleer in wp-activate.php of de constante op false staat. Zo niet, zet het op false, sla op, en test opnieuw. Leeg daarna eventueel de cache van je caching plugin.
3. Wat moet ik doen als de melding blijft staan, ook na alle stappen?
Probeer de onderhoudsmodus handmatig uit te schakelen via je hosting of vraag je hostingprovider om hulp. Soms helpt het om tijdelijk alle plugins te deactiveren en daarna WordPress opnieuw bij te werken.
4. Waardoor ontstaat deze melding meestal?
Vaak door een mislukte plugin update, een server time out, of een conflict met een caching plugin. Ook te weinig schijfruimte kan problemen geven. Werk updates stap voor stap af en controleer je hostinglimieten.
5. Is er risico dat ik gegevens verlies tijdens deze foutmelding?
Nee, normaal gesproken niet. De melding betekent alleen dat WordPress bezig was met een update en is niet schadelijk voor je data. Zolang je geen bestanden handmatig verwijdert buiten de instructies om, blijven je gegevens veilig.
6. Wat is de onderhoudsmodus in WordPress?
Tijdens updates zet WordPress je site tijdelijk in onderhoudsmodus en maakt het een .maintenance bestand aan. Klaar met updaten, dan verdwijnt het weer. Blijft het staan, dan moet je het handmatig weghalen.