Changing the server name in notification emails

[Ricardo_Rodriguez]

@kc1

but the links in notification emails still contain the old server name (IP address actually)

Hi! By doing some more research, I found that I’m facing the same issue on a new XWiki Debian 17.7.0 on Ubuntu 24.04.3 LTS box. In my case, the host part of the URLs in notifications points to http://localhost:8080. I will keep this thread posted if I find the solution. There are several related forum entries we need to pay attention to.

For instance:

Notification Mails: Links Point to "localhost" (And Setting xwiki.home Breaks the Annotation Feature)

You have the “Wiki Index” on the right “hamburger” menu. You don’t, xwiki.cfg have priority over the descriptor. But the point here is that xwiki.cfg is a last resort, not the first thing you should configure usually. The main wiki descriptor is generated with the host you use the first time you access it, but that assume your properly configured your proxy as an actually proxy and don’t hide the source host.

…and…

Use the main wiki descriptor server field for the domain name even in path based mode

Hi devs, Right now the server field in the wiki descriptor has a different meaning depending if we are in path based or domain based mode: domain based: the domain name of the URL path based: the alias used to indicate the target wiki in the path This means there is only two way to know the domain name for external URL in path based mode: the URL of the first request the property xwiki.home in xwiki.cfg file This also means there is no way to indicate the domain at wiki level contrary to …

Setting xwiki.home did the trick for me. No side effects identified so far. Annotation works fine. The variable reads now:

xwiki.home=https://our.public.domain.name/

Our XWiki server is behind a Nginx proxy, but I don’t find any reason why it must not work in your environment.

HTH!