Upgrade

Last modified by Eleni Cojocariu on 2026/03/31 15:34

Explanation

Warning

WIP: the whole documentation for the Upgrade topic is being under refactoring. Complete documentation is still in  Upgrade.

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:

  1. Backup your data.
    • Create a full backup of your data, just in case something goes wrong with the update/downgrade.
  2. 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.
  3. 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:

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.

Related

Get Connected