Briefly unavailable for scheduled maintenance in WordPress – oorzaken en oplossingen

Je wilt je WordPress-website bezoeken en krijgt ineens een scherm met de tekst: “Briefly unavailable for scheduled maintenance. Check back in a minute.” In het Nederlands zie je soms: “Tijdelijk niet beschikbaar vanwege gepland onderhoud. Probeer het over enkele minuten nog een keer.” Geen paniek – deze melding betekent meestal geen ernstig probleem en is eenvoudig op te lossen. In dit artikel lees je wat deze onderhoudsmelding inhoudt, waarom hij ontstaat en hoe je je site zelf weer online krijgt. Ook geef ik tips om te voorkomen dat je website in de toekomst in deze onderhoudsmodus blijft hangen.

Wat betekent deze melding en wanneer verschijnt hij?

“Briefly unavailable for scheduled maintenance. Check back in a minute.” is de standaardmelding die WordPress toont als je site tijdelijk in onderhoudsmodus staat. WordPress voert deze onderhoudsmodus automatisch uit tijdens het updaten van de core software, plugins of thema’s. Terwijl de updates installeren, is je website kort onbereikbaar voor bezoekers, zodat er niks kapot gaat als bestanden worden bijgewerkt. Bezoekers (en jijzelf) zien dan die onderhoudsmelding in plaats van je site.

In principe zou deze melding maar heel kort zichtbaar moeten zijn – vaak slechts een paar seconden tijdens een update. De boodschap is bedoeld om gebruikers te laten weten dat de site “even bezig is” en zo weer terugkomt. Normaal gesproken verlopen updates zo snel en soepel dat je nauwelijks iets merkt. Zodra WordPress klaar is met updaten, schakelt het de onderhoudsmodus weer uit en verdwijnt de melding vanzelf.

Technische achtergrond: hoe werkt de WordPress onderhoudsmodus?

Onder de motorkap zet WordPress je site in onderhoudsmodus door een tijdelijk bestand genaamd .maintenance aan te maken in de hoofdmappen van je website (de directory waar ook je wp-config.php staat). Zolang dat .maintenance-bestand bestaat, zal WordPress aan elke bezoeker de bovengenoemde melding tonen. Zodra de update succesvol voltooid is, verwijdert WordPress normaal gesproken dat .maintenance-bestand weer automatisch.

De melding blijft echter staan als er iets misgaat waardoor het .maintenance-bestand niet wordt verwijderd. In dat geval blijft je site “hangen” in onderhoudsmodus en blijft de onderhoudsmelding zichtbaar, ook al is de update intussen gestopt. Je website lijkt dan onbereikbaar te zijn totdat je ingrijpt.

Waarom zou het misgaan? De meest voorkomende oorzaak is dat een updateproces werd onderbroken of niet goed is afgerond. Enkele scenarios die dit kunnen veroorzaken zijn:

• Je sloot per ongeluk de browser of het tabblad terwijl een update nog bezig was (of je navigeerde weg).
• Je probeerde te veel updates tegelijk uit te voeren (bijvoorbeeld tientallen plugins/themes in één keer), waardoor er iets vastliep of vertraagde.
• Een update faalde door een serveronderbreking, timeout of gebrek aan resources (bijvoorbeeld een trage hostingserver of weinig geheugen).
• Een conflict of fout in de nieuwe plugin-/themaversie zorgde ervoor dat WordPress de onderhoudsmodus niet kon afsluiten.

In al deze gevallen blijft het .maintenance-bestand staan op de server, en daarmee blijft de site in onderhoudsmodus. Het goede nieuws is dat jij dit zelf eenvoudig kunt verhelpen door dat bestandje te verwijderen. Hieronder leg ik stap-voor-stap uit hoe.

Oplossing: je site weer uit de onderhoudsmodus halen

De oplossing voor een vastzittende onderhoudsmodus is simpel: het .maintenance-bestand handmatig verwijderen van je server. Zodra dat bestand weg is, zal WordPress direct de normale site weer tonen. Je kunt dit op verschillende manieren doen, afhankelijk van wat je het prettigst vindt of tot welke tools je toegang hebt:

Optie 1: .maintenance verwijderen via het hosting-bestandsbeheer (cPanel/DirectAdmin/Plesk)

Vrijwel elk hostingpakket biedt een bestandsbeheer in de controlepaneel (bijv. cPanel, DirectAdmin, Plesk, enz.). Hiermee kun je via je browser bij de bestanden van je site. Volg deze stappen (voor cPanel als voorbeeld):

1. Log in op het hosting controlepaneel (bijv. cPanel) van je website en ga naar de Bestandsbeheer (File Manager).
2. Navigeer naar de hoofdfolder van je WordPress-installatie. Dit is vaak public_html of de map waar je WordPress staat geïnstalleerd (bij een subdomein kan het een submap zijn).
3. Zoek in die map naar het bestand met de naam .maintenance. Let op: dit is een verborgen bestand (bestandsnaam begint met een punt). Schakel in de bestandsbeheerinstellingen “Show Hidden Files” (verborgen bestanden tonen) in als je het niet ziet.
4. Verwijder het .maintenance-bestand. In cPanel doe je dit door met rechts op het bestand te klikken en Delete te kiezen (vervolgens bevestigen). In DirectAdmin of andere panelen werkt het vergelijkbaar: selecteer .maintenance en verwijder.
5. Controleer je website. Laad de pagina opnieuw in je browser. Als het goed is, is de onderhoudsmelding nu verdwenen en is je site weer normaal toegankelijk.

Optie 2: .maintenance verwijderen via een FTP-programma

Heb je liever direct toegang tot de bestanden via een FTP-client (bijvoorbeeld FileZilla), dan kan dat ook. De stappen lijken erg op optie 1:

1. Maak verbinding met de server via FTP/SFTP. Open je FTP-programma en log in met je hosting-FTP-gegevens (host, gebruikersnaam, wachtwoord en poort).
2. Navigeer naar de WordPress root-map. Meestal is dit de hoofdmap waarin je WordPress-bestanden staan (bij veel hosts public_html genoemd). Je herkent het aan bestanden zoals wp-config.php en mappen als wp-content.
3. Zorg dat je verborgen bestanden weergeeft in je FTP-client. In FileZilla kun je bijvoorbeeld in het menu op Server klikken en Force showing hidden files aanvinken.
4. Zoek het bestand .maintenance in de lijst en verwijder het. In FileZilla klik je rechts op het bestand en kies je Delete.
5. Herlaad je site in de browser. De onderhoudsmodus zou nu direct opgeheven moeten zijn en je website verschijnt weer normaal.

Optie 3: onderhoudsmodus uitschakelen via WP-CLI (gevorderd)

Als je toegang hebt tot je server via SSH en bekend bent met WP-CLI (de command-line interface voor WordPress), kun je de onderhoudsmodus ook daarmee beëindigen. WP-CLI heeft namelijk een ingebouwde commando hiervoor:

wp maintenance-mode deactivate

Dit commando deactiveert de WordPress maintenance mode onmiddellijk door het .maintenance-bestand te verwijderen. Zodra je dit uitvoert, is je site weer toegankelijk. (Let op: WP-CLI is een geavanceerde optie. Gebruik dit alleen als je vertrouwd bent met de command line en WP-CLI correct is geïnstalleerd.)

Tip: in zeldzame gevallen blijft je site in onderhoudsmodus ondanks het verwijderen van .maintenance. Meestal betekent dit dat er nog iets anders mis is gegaan tijdens de update. Probeer in dat geval eventueel een andere oplossing, zoals het controleren van de wp-activate.php file op een foutieve instelling (geavanceerd). Maar in de meeste situaties is het verwijderen van .maintenance voldoende om het probleem direct op te lossen.

Tips om dit in de toekomst te voorkomen

Voorkomen is beter dan genezen. Hier zijn een aantal praktische tips om te zorgen dat je WordPress-site niet opnieuw vastloopt in onderhoudsmodus:

• Laat updates volledig afronden (niet onderbreken). Wees geduldig en sluit je browser of tabblad niet terwijl een update nog bezig is. Wacht tot WordPress meldt dat alle updates zijn voltooid (bijvoorbeeld het bericht “Maintenance mode disabled” of “Updates have been completed”). Pas dan is het veilig om de pagina te sluiten of iets anders te gaan doen.
• Update plugins en thema’s één voor één. Voer niet een massa updates tegelijk uit, maar installeer updates stapsgewijs. Door telkens één plugin of thema tegelijk bij te werken, verklein je de kans dat er iets hapert of vastloopt. Ook verklein je zo de kans op conflicten tussen meerdere gelijktijdige updates.
• Houd automatische updates in de gaten. Heb je automatische updates ingeschakeld voor WordPress core of plugins? Zorg dat je notificaties ontvangt en controleer je site kort nadat zulke auto-updates draaien. Automatische updates verlopen meestal probleemloos, maar als er toch iets misgaat, wil je het snel ontdekken. Overweeg eventueel om automatische updates uit te schakelen als je merkt dat deze vaker problemen veroorzaken, zodat je updates handmatig en gecontroleerd kunt uitvoeren.
• Gebruik een staging-omgeving voor grote updates. Veel goede hosts bieden een staging (testomgeving) waarop je veilig updates kunt uitproberen voordat je ze op je live site uitvoert. Door eerst op staging te testen, kun je eventuele fouten of conflicten oplossen voordat je je echte site bijwerkt. Dit voorkomt dat je live site vastloopt in onderhoudsmodus.
• Zorg voor een snelle, betrouwbare hosting. Soms raken updates in de knel door trage servers of beperkte resources. Een kwalitatieve hostingpartij met voldoende servercapaciteit zorgt ervoor dat updates sneller voltooien en minder kans hebben om te “timenen” of te falen. Als je regelmatig tegen vastlopende updates aanloopt, kan het lonen om je hostingpakket te upgraden of over te stappen naar een host die hier beter mee omgaat.

Met deze maatregelen verklein je de kans aanzienlijk dat je de onderhoudsmelding nog eens onnodig lang ziet. Updates zullen vaker soepel verlopen, en mocht er onverhoopt toch iets misgaan, dan ben je er snel bij.