CMS Maintenance

On this page

Xibo Maintenance for the CMS

Please note: Xibo Cloud Hosted customers and CMS instances that have XTR configured can skip the Maintenance Enabled / Maintenance Key sections as the Maintenance Tasks are run securely from the command line in XTR.

If the environment is not compatible with XTR it is necessary to arrange a 3rd party service to call the maintenance web route.


Maintenance is an important part of any system and should always be configured to keep the database and files in trim condition, give alerts when there are errors and run in the background.

When Xibo is running, logs and statistics slowly accumulate on the server and consume disk space. In extreme cases the sheer volume of those records can cause the CMS web interface to slow and become unresponsive.

It is also reassuring to know that if there is a problem with a Display and it stops checking in with the Xibo server, you will be notified by email so you can take action to resolve the problem.

The maintenance script can be scheduled to run periodically and perform background clean-up tasks such as deleting old logs and statistics and checking the status of the displays.


  • Maintenance is configured from the Settings page under the Administration section of the main CMS menu, from the Maintenance tab.

There are several options associated with the maintenance script:

  • Maintenance Enabled( MAINTENANCE_ENABLED ):

    • Off - All maintenance functionality is disabled.
    • On - All maintenance functionality is enabled. You can use any of the methods below to call the maintenance script on a schedule without specifying a key.
    • Protected - All maintenance functionality is enabled. You must specify the correct key when calling the maintenance script. This is to prevent unauthorised persons from repeatedly calling the script and generating large amounts of alert email.
  • Maintenance Key (MAINTENANCE_KEY) - The secret key required to allow the maintenance script to run when “Maintenance Enabled” is set to “Protected” mode.

  • Email Alerts (MAINTENANCE_EMAIL_ALERTS) - Globally enable or disable the sending of email alerts. You can enable/disable alerts for individual displays in Display Management.

    For Xibo Cloud Hosting customers, Max Log Age and Max Statistics Age are set and locked.

  • Max Log Age (MAINTENANCE_LOG_MAXAGE) - How many days worth of log messages to keep. Logs older than specified will be deleted. Set to 0 to keep all logs indefinitely.

  • Max Statistics Age (MAINTENANCE_STAT_MAXAGE) - How many days worth of statistics to keep. Statistics older than specified will be deleted. Set to 0 to keep all statistics indefinitely.

  • Max Display Timeout (MAINTENANCE_ALERT_TOUT) - Globally configure how many minutes after a display lasts connects to the server we should consider it to have a problem and cause an alert to be sent. You can override this default for individual displays in Display Management. You should make sure this time is longer than the collection interval you have configured on your players to avoid false positive alerts.

Set email address information to send emails generated by the CMS from the Network tab:

  • Admin email address (mail_to) - The overrall CMS administrator email that you want to recieve all copies of email notifications to be sent to.
  • Sending email address (mail_from) - The address to show who the alert emails are from. (e.g
  • Sending email name - The name you want to show as the sender. (e.g Auser CMS)