How to change the public domain name of an Xwiki installation

What are the guidelines to migrate an xwiki installation to another domain?
The installation stays on the same server, its just that the domain name to access the main wiki website changes

Good question. I don’t know, so I decided to try it out for myself.

My installation is Apache proxying requests to Tomcat/XWiki.

In my virtual host configuration for xwiki, I have the following:

<VirtualHost *:443>

So, I added a new domain to my VirtualHost configuration using ServerAlias, like so:

<VirtualHost *:443>

and restarted Apache.

Normally I access my wiki with https://info.example.comt/xwiki/bin/view/Main/ so I tried and it worked exactly as expected.

Just to be sure, I used the developer tools to check all the network requests to xwiki, and all of them were using the new domain.

So it seems like a very straight forward change with no hassles for a single apache proxied to tomcat, single instance xwiki installation.

Does that answer your question?

1 Like

Hi Yuri. From an XWiki POV I think you only need to edit the wiki descriptor to adjust any alias you’d have put there. See


1 Like