Nextcloud Maintenance Window Start Time Configuration¶

If you see the message, "Server has no maintenance window start time configured'

To configure the maintenance window start time in Nextcloud,

edit /nextcloud/config/config.php and use the following key in your configuration file:

'maintenance_window_start' => 1,

This key activates the maintenance window start time feature, allowing you to specify a time for resource-intensive daily background tasks to run during periods of low usage. Ensure to set the value to '1' to enable this functionality.

maintenance_window_start
Note

This setting is only taken into account in cron mode.

In the config/config.php file you can specify this config. Some background jobs only run once a day. When an hour is defined (timezone is UTC) for this config, the background jobs which advertise themselves as not time-sensitive will be delayed during the “working” hours and only run in the 4 hours after the given time. This is e.g. used for activity expiration, suspicious login training, and update checks.

A value of 1 e.g. will only run these background jobs between 01:00am UTC and 05:00am UTC:

'maintenance_window_start' => 1,
If you don’t care when these jobs run, you can set the value to 100, but beware that resource intensive jobs may then run unnecessarily during high usage periods. This may lead to slower performance and a lower quality user experience.

This setting may also be set directly via occ just like any other configuration parameter:

occ config:system:set maintenance_window_start --type=integer --value=1