XOOPS Install and Upgrade
doc-v2.5.10
doc-v2.5.10
  • The XOOPS Install & Upgrade Guide
  • The XOOPS Install & Upgrade Guide - en
  • Introduction
  • Languages
  • Installation
    • Requirements​
    • Preparations​
      • phpinfo
    • Special Topics
    • ​Installation​
      • Language Selection​
      • Welcome​
      • ​Configuration Check​
      • ​Path Setting​
      • Database Connection​
      • Database Configuration​
      • Save Configuration​
      • Table Creation​
      • Initial Settings​
      • ​Data Insertion​
      • Site Configuration​
      • Select Theme​
      • Modules Installation​
      • ​Welcome​
      • Cleanup​
  • First Steps
    • Review System Settings
      • Configure Emai​l
      • Add a module
  • Upgrading
    • ​Upgrading​
      • Preparations for Upgrade​
      • Running Upgrade​
      • Troubleshooting​
      • ​After the Upgrade​
  • Moving a Site
    • Moving a Site
  • Notes for Developers
    • Notes for Developers
  • Tools
    • Tools of the Trade
  • License
    • License
Powered by GitBook
On this page

Was this helpful?

  1. Upgrading

​Upgrading​

PreviousAdd a moduleNextPreparations for Upgrade​

Last updated 5 years ago

Was this helpful?

The XOOPS Upgrader examines your XOOPS installation and applies any needed patches to make it compatible with the new XOOPS code. Patches may include database changes, adding default settings for new configuration items, file and data updates, and more.

The upgrader is tested against a variety of XOOPS installation, both old and new, but the process is smoothest with the most recent XOOPS releases. If you are upgrading a older system and need help, please visit our support forums at

Quick Overview

  • Make a full backup of site files and database

  • It may be helpful to enable debugging in System Options - Preferences - General Settings

  • It is wise to turn your site off in System Options - Preferences - General Settings

  • Copy the contents of the distribution htdocs directory into your web root directory. Be careful not to overwrite any customize configuration or theme files.

  • Copy the contents of htdocs/xoops_lib to your relocated/renamed xoops_lib as applicable

  • Copy the contents of htdocs/xoops_data to your relocated/renamed xoops_data as applicable

  • If you are upgrading from a pre-2.5 series XOOPS, check your mainfile.php for any old protector modifications and remove if found

  • Copy the distribution upgrade directory into your web root directory

  • Point your browser to your-site-url/upgrade/ and follow the prompts

  • Log in and step through any needed updates with the "Continue" button

  • At the end, upgrade the system module

  • Also update pm, profile and protector modules if installed

  • Don't forget to turn your site back on, if needed

https://xoops.org/modules/newbb/