U klikt op ‘Bijwerken’ in WordPress en even later verschijnt op uw website: “Briefly unavailable for scheduled maintenance. Check back in a minute.” U wacht een minuut. Vijf minuten. Een kwartier. Het bericht blijft staan. Uw site is vast komen te zitten in de onderhoudsmodus.
Wat is er gebeurd?
Als WordPress een update start, maakt het een bestand aan op uw server: .maintenance in de root-map van uw WordPress-installatie. Dit bestand activeert de onderhoudspagina. Na een geslaagde update verwijdert WordPress dit bestand automatisch. Als de update mislukt of onderbroken wordt — door een time-out, verbindingsprobleem of PHP-fout — wordt het bestand niet verwijderd. Uw site blijft in onderhoudsmodus hangen.
De oplossing: verwijder het .maintenance-bestand
Verbind via FTP met uw server en navigeer naar de root-map van uw WordPress-installatie (de map waar ook wp-config.php staat). Zoek het bestand .maintenance. Let op: bestanden die beginnen met een punt zijn op sommige FTP-programma’s verborgen — zet ‘verborgen bestanden tonen’ aan in uw FTP-client. Verwijder het bestand. Uw site is direct weer online.
Wat nu met de mislukte update?
Na het verwijderen van het .maintenance-bestand moet u uitzoeken waarom de update mislukt is. Probeer de update opnieuw via het dashboard. Als het opnieuw mislukt, controleer dan: heeft uw server voldoende geheugen (PHP Memory Limit)? Is er voldoende schijfruimte? Bij aanhoudende problemen kunt u de plugin of het thema ook handmatig bijwerken via FTP.
💡 FRL Tip: Maak altijd een backup voor u updates uitvoert. Als een update mislukt en u een backup heeft, kunt u de site herstellen naar de werkende situatie terwijl u het probleem uitzoekt.