Steps

To upgrade an existing XWiki instance that was installed using Docker:

1. Ensure your data and configurations are preserved:
   • The XWiki data directory is mounted to the host (persistent volume).
   • Any customized configuration files are also mapped to the host.
2. Stop the currently running XWiki container. The database container should remain running.
3. Review the release notes for all intermediate versions between your current version and the target version.
   • Pay attention to:
     • Required manual migration steps,
     • Configuration changes,
     • Deprecated features.
4. Apply any required changes before proceeding (e.g., update configuration files, if neeeded).
5. Start a new container using the new XWiki version.

Related

• Upgrade.