Steps

To upgrade an XWiki instance installed using Docker, start a container of the new version against the data of the old one:

1. Check that the XWiki data directory is mounted on the host as a persistent volume, and that any customized configuration file is mapped there too.
2. Check the Release Notes 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.
3. Stop the XWiki container, leaving the database container running.
4. Apply the changes the release notes require, to the configuration files on the host.
5. Start a container of the new XWiki version, mounting the same volumes.
6. Upgrade the flavor from a browser, which the Distribution Wizard offers as soon as you log in.

The new container then serves the content of the old one, and the previous image can be removed once you have checked the wiki.

FAQ

Do I need to upgrade the database container as well?

Not as part of an XWiki upgrade — the database keeps its own lifecycle. Check the prerequisites of the new XWiki version, which is where a raised minimum database version would be announced.

Related

• Install XWiki using Docker.
• XWiki Docker Troubleshooting.