Maintenance Mode

Maintenance Mode nearata/flarum-ext-maintenance-mode

Customizable maintenance mode

Maintenance Mode

Customizable maintenance mode


composer require nearata/flarum-ext-maintenance-mode:"*"


composer update nearata/flarum-ext-maintenance-mode:"*"
php flarum cache:clear


composer remove nearata/flarum-ext-maintenance-mode
php flarum cache:clear

How to use

Switch the Maintenance Mode in the extension settings page.

With a command

php flarum nearataMaintenanceMode:toggle <true or false>

With API endpoint

PATCH /api/nearata/maintenanceMode/enabled
  "value": true or false

if the body is empty, it will be evaluated as false.

An empty response is returned either way.

How to style

To change the style of the page, there's no other way but to override the file itself.

Follow the below link to see a how-to:

How to bypass maintenance

If you have permissions to bypass the maintenance mode, you can run the below command to generate a link to login in a authorized user.

Assure you are in the Flarum root folder:

php flarum nearataMaintenanceMode:auth <user_id>


  • If the database is inaccessible, this situation is not handled.


  • Version 1.0.0.

    Likely works with Flarum v1.8.5.

  • 1 additional versions.
  • Extension created.