Upgrade
Last modified by Eleni Cojocariu on 2026/03/31 15:34
Content
Explanation
You can upgrade your XWiki instance to newer versions to stay up to date, benefit from the best new features and keep your data safe from security threats.
Before proceeding with an upgrade, it is strongly recommended to:
- Backup your data.
- Create a full backup of your data, just in case something goes wrong with the update/downgrade.
- Upgrade the extensions first.
- It is recommended to update all installed extensions to make sure that all they are up to date since new versions might contain compatibility fixes that would have otherwise preventing the new version fully start.
- Check the Release Notes.
- Review the release notes for the versions between your current version and the target version.
- Pay special attention to sections titled
"Issues specific to XWiki <version>"and to any changes in hardware of software requirements (prerequisites).
There are multiple methods to upgrade XWiki depending on how many data you need to migrate or how experienced you are with different tools. In the majority of cases an upgrade consists of two parts:
- Part 1: Upgrading the distribution (server side).
- Part 2: Upgrading the flavor (wiki Pages).
FAQ
Do I need to upgrade to each intermediary version?
No. XWiki provides migration paths that allow you to upgrade directly from any older version to a newer one. You do not need to install intermediary versions.
More
To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.