Maintenance mode in Laravel - Mini Project: Build & Apply

Enable and Customize Maintenance Mode in Laravel

📖 Scenario: You are managing a Laravel website that needs to be temporarily unavailable for updates. You want to enable maintenance mode so visitors see a friendly message while you work.

🎯 Goal: Learn how to enable Laravel's maintenance mode, customize the message shown to visitors, and disable maintenance mode when done.

📋 What You'll Learn

Enable Laravel maintenance mode using the artisan command

Create a custom view for the maintenance page

Configure Laravel to use the custom maintenance view

Disable maintenance mode to bring the site back online

💡 Why This Matters

🌍 Real World

Websites often need to be taken offline temporarily for updates or fixes. Maintenance mode helps show visitors a friendly message instead of errors.

💼 Career

Knowing how to manage maintenance mode is essential for web developers and system administrators to ensure smooth user experience during site updates.

1

Enable Maintenance Mode

Run the artisan command php artisan down in your Laravel project root to enable maintenance mode.

Laravel

# Run the artisan command to enable maintenance mode
# Your code here

Need a hint?

Use the Laravel artisan command php artisan down to activate maintenance mode.

2

Create a Custom Maintenance View

Create a Blade view file named resources/views/errors/503.blade.php with the content: <h1>Site Under Maintenance</h1><p>We will be back shortly.</p>

Laravel

php artisan down


# Your code here

Need a hint?

Create a Blade template file at resources/views/errors/503.blade.php with your maintenance message.

3

Configure Laravel to Use the Custom Maintenance View

In app/Exceptions/Handler.php, add a render() method that returns the custom 503 view when the application is in maintenance mode using return response()->view('errors.503', [], 503);

Laravel

php artisan down


Site Under Maintenance
We will be back shortly.

// Add the render method in app/Exceptions/Handler.php
# Your code here

Need a hint?

Override the render() method in the exception handler to show your custom maintenance page.

4

Disable Maintenance Mode

Run the artisan command php artisan up to disable maintenance mode and bring the site back online.

Laravel

php artisan down


Site Under Maintenance
We will be back shortly.

// In app/Exceptions/Handler.php
public function render($request, Throwable $exception)
{
    if ($exception instanceof \Illuminate\Foundation\Http\Exceptions\MaintenanceModeException) {
        return response()->view('errors.503', [], 503);
    }
    return parent::render($request, $exception);
}

# Run the artisan command to disable maintenance mode
# Your code here

Need a hint?

Use the artisan command php artisan up to disable maintenance mode.