Explanation

Upgrading an XWiki instance brings it to a newer version, so that it benefits from the latest features and stops being exposed to the security issues fixed since.

Before starting:

• Back up your data, so that the instance can be restored if the upgrade goes wrong.
• Update the installed extensions, because a newer version of an extension often carries the compatibility fix the new XWiki version needs.
• Read the Release Notes of every version between the one you are running and the one you are upgrading to, in particular the sections named "Issues specific to XWiki <version>" and any change to the prerequisites.

An upgrade then has two parts, in this order:

• Upgrading the distribution — the XWiki software on the server, replaced from the filesystem or through the package manager.
• Upgrading the flavor — the wiki Pages, updated from a browser.

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.

Can I return to the previous version if the upgrade goes wrong?

Restoring the backup you took beforehand is the reliable route, because an upgrade changes the database schema and the permanent directory; see Downgrade your Wiki.

More

To find more about the current topic, you can search, select an highlighted topic, or use the table below and filter the columns to narrow your choices.

Related

• Downgrade.
• Support Strategy.