Upgrade Manual/Custom Install

On this page

Upgrade Manual/Custom Install

Upgrading a manual/custom installation happens in 3 stages:

  1. Requirements
  2. Upgrade the CMS files
    (Upgrading the CMS files is a manual process that should be completed by your web server administrator).
  3. Upgrade the database
    (In 2.0.0 or later and 3.0.0 or later, upgrading the CMS can be done by your web server administrator from the terminal. In versions earlier than 2.0.0 upgrading is completed in a wizard and can be done by the CMS administrator).

Please check the release notes for the version you want to upgrade to before starting the upgrade.


You should always take a backup before upgrading your CMS Installation.
Screenshot/Image

Upgrading to v1.8:

  • Ensure your environment meets the requirements for installation. If it does not then correct that before continuing.
  • Backup settings.php from your installation (found in web/settings.php )
  • Manually take a backup of your database
  • Replace your existing installation with the new version from the tar.gz or zip file. Do not copy over the top.
  • Replace your backup settings.php file in your Xibo installation directory
  • Browse to http://your.server/path as normal

Upgrading to v2.0.0 or later and v3.0.0 or later:

  • Open a terminal
  • cd into your installation folder
  • run vendor/bin/phinx migrate -c phinx.php

Upgrading to a version before v2.0.0:

  • Log in as an administrator.
  • The upgrade wizard will open and show the list of upgrade steps.
  • Press start to run through them.

Once the upgrade has completed, login to your CMS and click the Verify All button from the Modules page under the Administration section of the CMS main menu. This is to ensure any updates/enhancements are applied to any module files which may have changed between versions.