Move XWiki to a New Server and Upgrade it

Last modified by Eleni Cojocariu on 2026/03/06 14:41

Content

Steps

To move an existing XWiki instance to a different server and upgrade it at the same time:

  1. Install the same XWiki version on the new server as the one running on the old server.
  2. Move the existing data (database and permananet data (i.e. the /data directory)) to the new server.
  3. Start the instance on the new server.
  4. Verify that all content and features work correctly.
  5. Upgrade XWiki by following the standard upgrade procedure.

FAQ

Why should the server migration be separated from the XWiki upgarde process?

Separating the server migration from the upgrade process makes it easier to identify and fix problems and avoid mixing infrastructure issues with data migration issues.

Get Connected