XWiki

Java 21 Wiki d'entreprise ⏱ 12 min Avancé Plan : Pro Vérifié 2026-05-23

À quoi ça sert

XWiki est un wiki d'entreprise extensible, alternative open source à Confluence. Pages structurées, applications métier sur mesure (CRM, base de connaissances, suivi de réunions), modèles, droits fins par page et par espace. Plus de 600 extensions officielles.

Cette fiche déploie XWiki 17.10.8 LTS (Long Term Support) sur Java 21 et Tomcat 10, avec PostgreSQL pour les pages et un volume persistant pour les pièces jointes.

Ce que vous obtenez

Édition WYSIWYG, syntaxe XWiki ou Markdown, historique complet par page
App Within Minutes : créer des applications structurées sans coder
API REST + WebSocket, scripting Velocity / Groovy côté serveur
Droits fins (lecture, édition, admin) par page, espace ou groupe
Plus de 600 extensions officielles : LDAP, OIDC, captcha, blog, forum, etc.
Recherche full-text Solr intégrée
Export PDF, OpenOffice, XAR, multi-langue natif

Pré-requis

Compte di2amp actif. Plan minimal : Pro. Addons utilisés : Postgres (obligatoire). Volume persistant : 20 Gio pour les pièces jointes.

Si vous n'avez pas encore créé de compte, suivez le guide de démarrage avant cette page.

001 Déploiement manuel via CLI

Image officielle xwiki:lts-postgres-tomcat. XWiki est déployé directement sur webapps/ROOT dans Tomcat : le contexte est la racine, pas /xwiki/.

01 Créer l'app et le Postgres

$ paas apps:create mon-wiki && paas addons:create postgres-standard --app mon-wiki

02 Configurer le wrapper de démarrage

Trois patches sont appliqués sur xwiki.cfg et xwiki.properties avant le lancement de Tomcat :

xwiki.superadminpassword=<mot_de_passe_choisi>
xwiki.action.csrfprotection=false
distribution.automaticStartOnMainWiki=0

Ces réglages activent le compte superadmin, désactivent la protection CSRF pour les appels API serveur-à-serveur, et empêchent le Distribution Wizard d'intercepter le boot.

03 Déployer

$ git push paas main

Le premier démarrage initialise la base (40 tables) et importe les pages standard via le mécanisme d'extensions XWiki.

002 URL et navigation — point critique

À retenir : XWiki étant déployé sur webapps/ROOT, l'URL des pages ne contient pas de préfixe /xwiki/. Si vous ajoutez ce préfixe par habitude, XWiki l'interprète comme un espace de pages imbriqué et renvoie une page "nouvelle" (404 logique) au lieu de la page réelle.

Bonne URL : https://mon-wiki.runtime.di2amp.com/bin/view/Main/WebHome

Mauvaise URL : https://mon-wiki.runtime.di2amp.com/xwiki/bin/view/Main/WebHome (ne fonctionne pas).

Pour vérifier qu'une page est bien chargée et n'est pas un placeholder, regardez l'attribut data-xwiki-isnew dans le HTML : il vaut false pour une page réelle, true pour une page placeholder à créer.