Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).

XWiki über APT unter Debian und Ubuntu installieren¶

Mit den offiziellen DEB-Paketen lässt sich XWiki einschließlich Java-Laufzeit, Anwendungsserver und Datenbank installieren. Diese Anleitung führt durch eine stabile Standardinstallation auf einem Debian- oder Ubuntu-Server.

Hinweis

Die verfügbaren Paketnamen und Java-Anforderungen hängen von der XWiki-Version und der verwendeten Distribution ab. Die Paketliste sollte deshalb vor der Installation immer mit apt search xwiki geprüft werden. Stand dieser Anleitung: August 2026.

Voraussetzungen¶

ein unterstütztes Debian- oder Ubuntu-System
ein Benutzerkonto mit sudo-Rechten
Internetzugang zum XWiki-Paketarchiv
ausreichend Arbeitsspeicher für Java, XWiki und die Datenbank

Achtung

Vor einer Installation auf einem bereits genutzten Server sollten Datenbanken und Konfigurationsdateien gesichert werden. Außerdem darf nicht gleichzeitig eine andere Anwendung die vorgesehenen HTTP-Ports belegen.

1. XWiki-Paketquelle einrichten¶

Zuerst werden der Signaturschlüssel und die Paketquelle für stabile XWiki-Versionen eingetragen:

sudo wget https://maven.xwiki.org/xwiki-keyring.gpg \
  -O /usr/share/keyrings/xwiki-keyring.gpg

sudo wget https://maven.xwiki.org/stable/xwiki-stable.list \
  -O /etc/apt/sources.list.d/xwiki-stable.list

sudo apt update

Für produktive Systeme eignen sich in der Regel der Stable- oder der LTS-Zweig:

Paketquelle	Zweck
`stable/xwiki-stable.list`	stabile Veröffentlichungen ohne Meilensteine und Release Candidates
`lts/xwiki-lts.list`	alle veröffentlichten Cycle-LTS-Versionen
`lts/xwiki-lts-latest.list`	jeweils neueste verfügbare LTS-Version
`releases/xwiki-releases.list`	alle Veröffentlichungen einschließlich Vorabversionen

Tipp

Für einen Server mit möglichst seltenen Versionssprüngen ist die LTS-Paketquelle eine gute Wahl. Zum Wechseln muss im zweiten wget-Befehl lediglich die URL der gewünschten Paketquelle eingesetzt werden.

2. Verfügbare Pakete prüfen¶

apt search xwiki

Der Paketname kombiniert Anwendungsserver und Datenbank. Die Komplettpakete folgen normalerweise diesem Muster:

xwiki-xjetty-mariadb
xwiki-xjetty-mysql
xwiki-xjetty-pgsql
xwiki-tomcat10-mariadb
xwiki-tomcat10-mysql
xwiki-tomcat10-pgsql

Neuere Distributionen können stattdessen Pakete für Tomcat 11 anbieten. Maßgeblich ist die Ausgabe von apt search xwiki.

Anwendungsserver auswählen¶

Variante	Geeignet für
XJetty	unkomplizierte Neuinstallation mit einem für XWiki vorbereiteten Jetty
Tomcat	Umgebungen, in denen Tomcat bereits administriert oder ausdrücklich vorausgesetzt wird

Datenbank auswählen¶

Variante	Paketbestandteil
MariaDB	`mariadb`
MySQL	`mysql`
PostgreSQL	`pgsql`

Achtung

Wird tatsächlich MariaDB eingesetzt, sollte auch das MariaDB-Paket gewählt werden. Das MySQL-Paket ist für einen echten MySQL-Server vorgesehen.

3. XWiki installieren¶

Für eine einfache Standardinstallation mit XJetty und MariaDB:

sudo apt install xwiki-xjetty-mariadb

Alternativ kann beispielsweise Tomcat mit PostgreSQL installiert werden:

sudo apt install xwiki-tomcat10-pgsql

APT installiert die benötigten Abhängigkeiten. Während der Einrichtung kann dbconfig-common nach der Datenbankkonfiguration und nach Kennwörtern fragen. Bei einer neuen Datenbankinstallation kann die automatische Konfiguration in der Regel übernommen werden.

Achtung

Datenbankkennwörter sicher aufbewahren. Bei älteren XWiki-Paketständen können Sonderzeichen im automatisch eingetragenen Datenbankkennwort Startprobleme verursachen. Tritt dieser Fehler auf, sollten die Zugangsdaten in /etc/xwiki/hibernate.cfg.xml geprüft werden.

Nach der Installation laufen die Dienste normalerweise bereits und werden beim Systemstart automatisch aktiviert. Der Status lässt sich abhängig von der gewählten Variante prüfen:

XJettyTomcat 10

sudo systemctl status xwiki

sudo systemctl status tomcat10

4. Ersteinrichtung im Browser¶

XWiki ist standardmäßig unter folgender URL erreichbar:

http://SERVER-IP:8080/xwiki

Beim ersten Aufruf startet der Distribution Wizard. Er installiert die Standardoberfläche und führt durch das Anlegen des Administratorkontos. Eine frisch installierte Instanz enthält vorher noch keine regulären Wiki-Seiten oder Benutzerkonten.

Tipp

Ist die Seite nicht erreichbar, zuerst den Dienststatus und anschließend die Protokolle prüfen. Zusätzlich müssen eine lokale Firewall oder eine vorgeschaltete Cloud-Firewall den verwendeten Port zulassen.

Achtung: Ersteinrichtung nicht öffentlich exponieren

Wer den Port während der Ersteinrichtung erreicht, sieht den unfertigen Distribution Wizard und könnte das erste Administratorkonto kapern, bevor du selbst fertig bist — zudem läuft die Verbindung an dieser Stelle noch als reines HTTP, da Nginx/TLS meist erst danach eingerichtet wird. Statt den Port dafür in der Firewall zu öffnen, empfiehlt sich ein SSH-Tunnel.

Sicherer Weg über SSH-Tunnel (empfohlen, Tomcat)¶

Bei der Tomcat-Variante lässt sich der Connector per address-Attribut auf localhost beschränken, sodass der Port von außen grundsätzlich unerreichbar ist — unabhängig von jeder Firewall-Regel:

sudo nano /etc/tomcat10/server.xml

<Connector address="127.0.0.1" port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" />

sudo systemctl restart tomcat10

Auf dem eigenen Rechner den Port per Local Forwarding zum Server tunneln:

ssh -L 8080:127.0.0.1:8080 admin@SERVER-IP

Solange die SSH-Sitzung besteht, ist der Distribution Wizard im eigenen Browser unter http://127.0.0.1:8080/xwiki erreichbar. Mehr zu Local Forwarding und weiteren Tunnel-Varianten: SSH-Tunnel: Portweiterleitung über SSH.

Hinweis

Anders als bei einer reinen Ersteinrichtungshilfe sollte die address="127.0.0.1"-Bindung bei XWiki dauerhaft bestehen bleiben: Nginx läuft auf demselben Host und erreicht Tomcat ohnehin über localhost (siehe XWiki installieren und über Nginx bereitstellen). Der Tunnel ist nur das temporäre Zugangsmittel für dich selbst, bevor Nginx als dauerhafter, öffentlicher Zugangsweg konfiguriert ist.

Für die XJetty-Variante gilt eine andere, hier nicht behandelte Jetty-Konfiguration für die Bindung an localhost — dort bleibt vorerst nur die kurzzeitige, in der Firewall freigegebene Variante von oben.

Als zweite, unabhängige Absicherungsebene sollte der Tomcat-Port (hier 8080, bei einer Portänderung entsprechend anpassen) zusätzlich nie in der Firewall freigegeben werden:

sudo ufw allow "Nginx Full"
sudo ufw deny 8080/tcp
sudo ufw status verbose

Details dazu: UFW-Firewall installieren und steuern.

5. Java und Arbeitsspeicher prüfen¶

Aktuelle XWiki-Versionen benötigen eine unterstützte Java-Version. XWiki 16 benötigt mindestens Java 17; ab XWiki 18 ist Java 21 erforderlich. Die tatsächlich verwendete Version zeigt:

java -version

Bei Tomcat befindet sich die distributionsabhängige Startkonfiguration üblicherweise in /etc/default/tomcat10 beziehungsweise /etc/default/tomcat11. Zu niedrige Java-Speichergrenzen können dazu führen, dass XWiki nicht vollständig startet oder unter Last instabil wird.

Nach einer Änderung muss der betreffende Dienst neu gestartet werden:

XJettyTomcat 10

sudo systemctl restart xwiki

sudo systemctl restart tomcat10

6. XWiki aktualisieren¶

Vor einer Aktualisierung sollten mindestens die Datenbank, /etc/xwiki/ und /var/lib/xwiki/data/ gesichert werden.

sudo apt update
sudo apt upgrade

Soll ausschließlich das installierte XWiki-Metapaket aktualisiert werden, wird dessen genauer Name angegeben, zum Beispiel:

sudo apt install xwiki-xjetty-mariadb

Nach einem Versionswechsel wird XWiki im Browser geöffnet. Der Distribution Wizard aktualisiert anschließend die installierte Oberfläche und Erweiterungen.

Achtung

Bei einem Wechsel der unterstützten Tomcat-Hauptversion kann sich auch der XWiki-Paketname ändern. In diesem Fall zuerst die aktuellen Pakete mit apt search xwiki ermitteln und die offiziellen Upgrade-Hinweise für die Zielversion lesen.

7. Fehler untersuchen¶

Dienstprotokolle anzeigen¶

XJettyTomcat 10

sudo journalctl -u xwiki -n 200 --no-pager
sudo journalctl -u xwiki -f

Zusätzliche XWiki-Protokolle können unter /var/log/xwiki/ liegen.

sudo journalctl -u tomcat10 -n 200 --no-pager
sudo journalctl -u tomcat10 -f

Je nach Distribution befinden sich weitere Protokolle unter /var/log/tomcat10/.

Portbelegung prüfen¶

sudo ss -ltnp

Paketinstallation reparieren¶

sudo dpkg --configure -a
sudo apt --fix-broken install

Wichtige Verzeichnisse¶

Pfad	Inhalt
`/etc/xwiki/`	zentrale XWiki-Konfiguration
`/var/lib/xwiki/data/`	dauerhafte XWiki-Daten, unter anderem Dateianhänge
`/usr/lib/xwiki/`	installierte Webanwendung
`/var/log/xwiki/`	XJetty-/XWiki-Protokolle, sofern dateibasiertes Logging aktiv ist
`/var/log/tomcat10/`	Tomcat-Protokolle bei einer Tomcat-10-Installation

Weiterführende Seiten¶

Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).