Purpose

XWiki is a comprehensive Content Content Management System (CMS) in the form of a Wiki. XWiki, on the market, is the competitor to Confluence and MediaWiki.

Properties

Topology

The stack consists of two containers:

• cms-xwiki hosts the XWiki appliation and serves the web pages
• cms-xwiki-postgresql contains the RDBMS which backs XWiki

Configuration

See also the variables which control integration of the stack into the reverse proxy.
For changes to take effect the stack has to be reinstalled.

First Steps

When accessed for the first time an automatic setup routine starts ("XWiki is initializing"). This takes one to three minutes, then the following dialog appears:

After pressing Continue you are requested to create the administrator's account:

Now click Register and login and you will get logged in to this administrator account. A confirmation screen is displayed which you respond to by pressing Continue.

This brings up the flavor selection dialog. If the flavor list is empty try to reload this page until at least the "XWiki Standard Flavor" shows up. XWiki uses this term for a set of preinstalled wiki pages which install features you might probably expect. You can also decide to not install anything (you can come back to the flavor installation later). The XWiki Standard Flavor is a good point to start. You need internet access to install a flavor because extension will be downloaded from the Xwiki extension repository. Select the flavor by clicking anywhere in its tile (not on the flavor title as this is alink to the flavor's install docs), then press Install this flavor.

This is followed by a confirmation screen. Press Install to start installation of the flavor. This takes a few seconds while a progress dialog is displayed. When the installation has finished press Continue. Then the second set of stuff is installed, taking up to three minutes. When finished a Continue button appears in the bottom right. Press it.

The starts a short tour around the Xwiki user interface. You step through the eight steps pressing Next, then end the tour by clicking End tour.

This completes the Xwiki setup and you are dropped into the start page of the wiki.

First Steps

The default look and feel consists of a customizable navigation bar to the left, the main wiki content in the middle and an again customizable content bar with tips and recent modification to the right.

For a first look on XWiki read through the Getting Started pages (navigate through it using the page list on the left).

When you click on the Hamburger icon to top right a menu slips in from the right. Beside some resource lists ("index") and the log out link there is an Administer Wiki item. It leads you to the admin interface where you can, among other things, manage user and rights (Xwiki has a group/role based authorization concept), install and deinstall extensions, manipulate the Look & Feel and configure the way how to edit wiki pages (there is both a WYSIWIG and a text based edit mode available). You find more on that in XWiki's Administrator Guide. 

For fast navigation you can use the breadcrumbs at the page top; clicking on the XWIKI logo in the top left (which, by the way, can also be replaced in the Look & Feel > Themes > Color Theme > Customize section of the administation space).

Learn more about XWiki in its User Guide, especially its Features section.

Important Files

• /data/xwiki/conf/xwiki.cfg in container cms-xwiki - central XWiki config file. XWiki must be restarted in order to bring changes into effect.

Administration Commands

Related Documents

• Most recent changes