Wiki source code of Upgrade XWiki Installed in Docker
Last modified by Eleni Cojocariu-testing account on 2026/08/18 12:17
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | To upgrade an XWiki instance [[installed using Docker>>documentation.xs.admin.installation.methods.install-xwiki-docker.WebHome]], start a container of the new version against the data of the old one: | ||
| 2 | |||
| 3 | 1. Check that the XWiki data directory is mounted on the host as a persistent volume, and that any [[customized configuration file>>documentation.xs.admin.installation.methods.install-xwiki-docker.configuration.configuration-files.WebHome]] is mapped there too. | ||
| 4 | 1. Check the [[Release Notes>>xwiki:ReleaseNotes.WebHome]] of every version between the one you are running and the one you are upgrading to, noting the manual migration steps, configuration changes and deprecated features they announce. | ||
| 5 | 1. Stop the XWiki container, leaving the database container running. | ||
| 6 | 1. Apply the changes the release notes require, to the configuration files on the host. | ||
| 7 | 1. Start a container of the new XWiki version, mounting the same volumes. | ||
| 8 | 1. [[Upgrade the flavor>>documentation.xs.admin.upgrade.flavor.WebHome]] from a browser, which the Distribution Wizard offers as soon as you log in. | ||
| 9 | |||
| 10 | The new container then serves the content of the old one, and the previous image can be removed once you have checked the wiki. |
