> For the complete documentation index, see [llms.txt](https://xoops.gitbook.io/xoops-install-upgrade/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xoops.gitbook.io/xoops-install-upgrade/doc-v2.5.10/upgrading/upgrade.md).

# ​Upgrading​

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 <https://xoops.org/modules/newbb/>

## 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&#x20;
* 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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://xoops.gitbook.io/xoops-install-upgrade/doc-v2.5.10/upgrading/upgrade.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.