Super admin in Docker environment

Hi we are trying to activate the Super admin, and do not know how to achieve this in a Docker Environment.

thanks in advance of your help


I’m not a docker user but I suppose you should modify the file /usr/local/tomcat/webapps/ROOT/WEB-INF/xwiki.cfg (inside your container) and change the line:
# xwiki.superadminpassword=system

(don’t forget to uncomment the line).

I hope it helps,


EDIT: you need to restart XWiki after the operation to enable superadmin.

Thanks a lot, in the documents on the website it says that we need to restart the servlet container after changing xwifi.cfg , how would this work/how would we restart in a docker environment?

This property is loaded when XWiki is started. So either your restart the servlet container (in your case it must be Tomcat), or the docker container. It should work in both cases.


See Loading... which has some comments explaining how to do this:

docker exec -ti <containerid> bash -l

You’ll need to stop/restart the container with:

docker restart <container id>

Vincent, this makes me thinking…

Shouldn’t the xwiki.cfg file be exported as a volume or a mapping on local docker node ? Modifications in docker container being ephemeral across reboots, changes in xwiki.cfg will be discarded.

In this particular case (superadmin), it shouldn’t be a problem as the superadmin is supposed to be a temporary account for troubleshooting and such but I can see examples where this could be a problem (such as LDAP configuration for example).

I agree. See Loading... and my comments there.