Wiki source code of Upgrade

Last modified by Eleni Cojocariu on 2026/08/13 15:26

Hide last authors
Eleni Cojocariu 2.1 1 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.
Eleni Cojocariu 1.10 2
Eleni Cojocariu 2.1 3 Before starting:
Eleni Cojocariu 1.1 4
Eleni Cojocariu 2.1 5 * [[Back up your data>>xwiki:Documentation.AdminGuide.Backup]], so that the instance can be restored if the upgrade goes wrong.
6 * [[Update the installed extensions>>extensions:Extension.Extension Manager Application||anchor="HUpgrade"]], because a newer version of an extension often carries the compatibility fix the new XWiki version needs.
7 * Read the [[Release Notes>>xwiki:ReleaseNotes.WebHome]] of every version between the one you are running and the one you are upgrading to, in particular the sections named {{code language="none"}}"Issues specific to XWiki <version>"{{/code}} and any change to the [[prerequisites>>documentation.xs.admin.installation.prerequisites.WebHome]].
Eleni Cojocariu 1.1 8
Eleni Cojocariu 2.1 9 An upgrade then has two parts, in this order:
Eleni Cojocariu 1.2 10
Eleni Cojocariu 2.1 11 * [[Upgrading the distribution>>documentation.xs.admin.upgrade.distribution.WebHome]] — the XWiki software on the server, replaced from the filesystem or through the package manager.
12 * [[Upgrading the flavor>>documentation.xs.admin.upgrade.flavor.WebHome]] — the wiki Pages, updated from a browser.

Get Connected