Configuration

Last modified by Eleni Cojocariu on 2026/04/15 16:07

Explanation

Warning

WIP: Refactoring from Configuration.

Configuring XWiki is an essential step after installation. There are several reasons why configuration is important:

  • Performance optimization (e.g., caching, store features),
  • Security configurations,
  • Feature customization (e.g., enabling/disabling modules, customizing the PDF export Look & Feel),
  • Integration setup (mail servers, external services),
  • Skin customisations, etc.

XWiki can be configured in two main ways:

  • Through Configuration Files (Server-side): /wiki/WEB-INF/xwiki.cfg and xwiki/WEB-INF/xwiki.properties. Some configuration options are only available in these files and cannot be modified from the Administration UI. In the future, all configuration options will be moved to xwiki.properties. It is recommended to stop the XWiki server, edit the Configuration files (xwiki.cfg and/or xwiki.properties), and then to restart the XWiki server. 
  • Through the Administration of the wiki. This allows the server to keep running while making the changes.

 

FAQ

What are other methods/tools to manage my XWiki instance?

The Admin Tools Application contains administration tools for managing a running XWiki instance.

More

To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.

Related

Get Connected