Khoi Pro You run an update, refresh your page, and see: “Briefly unavailable for scheduled maintenance. Please check back in a minute.” But it has been way longer than a minute. Your site is stuck, and you’re starting to worry. At CODE TOT, we manage high-traffic e-commerce sites where a “minute” of downtime means lost revenue—so we’ve perfected the art of bypassing this maintenance lock instantly.
Professional Tip: You can create a custom maintenance page that’s much more user-friendly than the default text. Simply create a file named maintenance.php in your wp-content folder and WordPress will use that instead during updates.
1. The 10-Second Emergency Fix
WordPress creates a temporary file named .maintenance in your site’s root directory during every update. If a script times out or a server hiccup occurs, this file remains and locks everyone out. To fix it, connect via SSH or RunCloud File Manager and delete it:
# From your WordPress root directory
rm .maintenance2. Why did it get “Stuck” in the first place?
Understanding the “why” is key to preventing it from happening again. The .maintenance file usually stays behind because of:
- PHP Execution Timeout: Your server is set to kill scripts after 30 seconds, but the plugin update took 45.
- Browser Closure: You closed the browser tab before the “Updates Complete” message appeared.
- Low Server Resources: Especially common on shared hosting during peak hours.
3. Prevention: The WP-CLI Method
For high-availability sites, we **never** update plugins through the WordPress dashboard. Instead, we use WP-CLI. It is faster, bypasses browser-side timeouts, and provides much better error reporting if an update fails:
# Update all plugins safely via SSH
wp plugin update --all4. Clearing the “Stale” Update Lock
Sometimes even after deleting .maintenance, you might see “Another update is currently in progress.” This is a secondary lock stored in your database. You can clear it instantly with this command:
# Clear the database update lock
wp option delete core_updater.lockConclusion
Don’t let a tiny file keep your business offline. By following these steps and shifting your update workflow to WP-CLI, you can ensure your WordPress site is always available for your customers. For a truly “maintenance-free” experience, consider our Managed Hosting Solutions.
