Configuration Files
Reference
The following table lists the main XWiki configuration files available in the Docker image. To customize them, mount Docker volumes from the host machine to the corresponding paths inside the container.
| Configuration Item | Path inside the Docker Image | Description |
|---|---|---|
| Permanent directory | /usr/local/xwiki | Persistent data. |
| xwiki.cfg | $WEB-INF/xwiki.cfg | Main XWiki configuration file. |
| xwiki.properties | $WEB-INF/xwiki.properties | Advanced XWiki properties. |
| hibernate.cfg.xml | $WEB-INF/hibernate.cfg.xml | Hibernate database configuration. |
| Clustering (JGroups) | $WEB-INF/observation/remote/jgroups | Cluster communication configuration. |
| logback.xml | $WEB-INF/classes/logback.xml | Logging configuration. |
| web.xml | $WEB-INF/web.xml | Web application deployment descriptor. $WEB-INF is the location of the XWiki WAR's WEB-INF directory, at /usr/local/tomcat/webapps/$CONTEXT_PATH/WEB-INF/. $CONTEXT_PATH is the Servlet context deployment name for the XWiki webapp, by default it's ROOT. |
FAQ
Are configuration files still copied automatically to the permanent directory?
No. Configuration files are no longer copied automatically from the Docker image to the permanent directory on first startup. For backward compatibility, if these files are already present in the permanent directory, they are still copied to their expected locations inside the container during startup.
Why is persistent storage needed for XWiki Docker installation?
Persistent storage is required to ensure that XWiki data is not lost when the container is stopped, restarted, or upgraded. To enable persistent storage, XWiki must be configured to store its data outside the container filesystem.
More
To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.
