JabJab.de Wiki

Diese Howto-Serie bezieht sich auf Debian 11 (Bullyseye). Es sollte allerdings sehr leicht sein, dieses Howto auf andere Distributionen anzuwenden. Wörter in spitzen Klammern < > bezeichnen einen Platzhalter, der durch eigene Werte sinnvoll ersetzt werden muss. In dem Howto geht es daher immer um die Domain <beispiel.de>, was durch deine eigene Domain ersetzt werden muss. Wörter in eckigen Klammern [ ] bezeichnen einzelne Tasten oder Menüs zum klicken.

Diese Howto-Serie ist als Copy-Paste Anleitung gedacht. Du musst also nur die Befehle kopieren und bei dir in der Console einfügen. Befehle erkennst du am Dollarzeichen ($):

$ ./das/ist/ein/befehl mit option

Das ist kein Befehl, sondern ein Hinweis.

Als Editor setze ich jed ein. Warum weiß ich auch nicht, ich bin damit aufgewachsen. Es gibt durchaus viele Gründe und effektivere Wege Dateien zu ändern. Darum soll es hier aber nicht gehen. Wenn ihr (Konfigurations-) Dateien verändert habt, endet das immer mit dem Satz:

Die Änderungen mit [STRG] + [x] und [STRG] + [s] speichern und den Editor mit [STRG] + [x] und [STRG] + [c] verlassen.

Das kannst abkürzen. Wenn du direkt [STRG] + [x] und [STRG] + [c] verwendest wirst du gefragt, ob du die Änderungen vor dem Verlassen speichern möchtest.

Wenn in Konfigurationsdateien Abstände mit Leerzeichen angezeigt sind, dann verwende bitte ausschließlich Leerzeichen über die Leertaste (Space). Bitte füge keine Tabs ein!

Die späteren Howtos geben in ihrer Einleitung immer an, welche Howtos vorausgesetzt werden. Diese müssen dann vorher abgearbeitet werden.

Dieses Howto beschränkt sich auf die Einrichtung einer einzigen Domain. Solltest du den XMPP Server für mehrere Domains betreiben wollen, wird das in späteren Howtos erklärt. Du solltest dann dieses Howto - wir hier verlinkt - zuerst lesen.

Es wird ein fertig installiertes (minimales) Debian System vorausgesetzt. Dazu gibt es sehr gute Anleitungen im Netz (z.B. https://www.howtoforge.com/tutorial/debian-minimal-server/). Wenn du deinen Server bei einem Hoster betreibst, bieten viele ein automatisches Installationsimage für Debian 11 (Bullseye) an.

Der Zugriff erfolgt entweder direkt über eine Tastatur und Bildschirm oder aus der Ferne via SSH. Du solltest daher grundlegende Kenntnisse mitbringen, wie SSH funktioniert.

Zusätzlich wird ein fertig eingerichteter (Sub-)Domainname benötigt. Deine Domain <beispiel.de> muss mindestens mit einem A Eintrag auf die IP deines Servers zeigen (zusätzlich AAAA für IPv6). Du brauchst also ggf. Zugriff auf die DNS Verwaltung bei deinem Hoster.

jed (ich favorisiere diesen Editor, wer vi oder etwas anderes nutzen möchte, ist herzlich eingeladen dies zu tun)
wget (zum Download von Dateien)

$ apt -y install jed wget

Wir erstellen uns einen ejabberd Benutzer:

$ adduser --disabled-login ejabberd

Lege Benutzer »ejabberd« an ...
Lege neue Gruppe »ejabberd« (1001) an ...
Lege neuen Benutzer »ejabberd« (1001) mit Gruppe »ejabberd« an ...
Erstelle Home-Verzeichnis »/home/ejabberd« ...
Kopiere Dateien aus »/etc/skel« ...
Benutzerinformationen für ejabberd werden geändert.
Geben Sie einen neuen Wert an oder drücken Sie ENTER für den Standardwert
        Vollständiger Name []: ejabberd User
        Zimmernummer []: 
        Telefon geschäftlich []: 
        Telefon privat []: 
        Sonstiges []: 
Sind die Informationen korrekt? [J/n] j

Evtl. erscheint die Ausgabe bei dir in englischer Sprache. Du brauchst nur einen Namen Anzugeben, weitere Informationen wie Zimmernummer kannst du frei lassen und nur mit [Enter] bestätigen.

Wir machen uns zu ejabberd um damit zu arbeiten:

$ su - ejabberd

ejabberd herunterladen und ausführbar machen:

$ wget -O ejabberd-22.10-1-linux-x64.run https://www.process-one.net/downloads/downloads-action.php?file=/22.10/ejabberd-22.10-1-linux-x64.run
$ chmod +x ejabberd-22.10-1-linux-x64.run

Installation starten:

$ ./ejabberd-22.10-1-linux-x64.run

Running without superuser privileges (installer wasn't invoked with „sudo“), cannot perform system-wide installation this way. Continue anyway? (y/n) [n] ← y

Install ejabberd below /home/ejabberd/opt? (y/n) [n] ← y

The following installation paths will be used: - /home/ejabberd/opt/ejabberd-22.10 - /home/ejabberd/opt/ejabberd (for configuration, database, and log files) Install ejabberd 22.10 now? (y/n) [n] ← y

Danach hast du zwei neue Pfade :

/home/ejabberd/opt/ejabberd für Konfgurationsdateien, Datenbank und Log Dateien. Dieses Verzeichnis wird bei Updates übernommen.
/home/ejabberd/opt/ejabberd-22.10 für ejabberd

Dies ist das erste Mal, dass ejabberd in getrennten Pfaden installiert wird. Zukünftige Updates werden nach /home/ejabberd/opt/ejabberd-xx-yy installiert.

In den folgenden Howtos werde ich Scripte vorstellen, die automatisiert Dinge tun. Damit nicht bei jedem Update die Pfade innerhalb der Scripte angepasst werden müssen, erstellen wir noch einen Link (vergleichbar mit einer Verknüpfung unter Windows):

$ ln -s /home/ejabberd/opt/ejabberd-22.10 /home/ejabberd/opt/ejd

Nach einem Update muss in Zukufnt lediglich dieser Link entfernt und mit der aktuellen Version neu erstellt werden:

$ rm opt/ejd
$ ln -s /home/ejabberd/opt/ejabberd-xx.yy /home/ejabberd/opt/ejd

Konfigurationsdatei öffnen:

$ jed opt/ejabberd/conf/ejabberd.yml

Das ist eine Basiskonfiguration, die du nach deinen Bedürfnissen anpassen kannst. Mehr dazu findest du in späteren Howtos.

Wir passen zuerst den Hostnamen an.

Suche nach:

hosts:
  - <deinhostname>

Und ersetze es mit deiner Domain:

hosts:
  - <beispiel.de>

Jetzt noch mqtt deaktivieren, das benötigen wir nicht und könnte beim Wechsel zu SQL Probleme verursachen.

Suche nach:

  -
    port: 1883
    ip: "::"
    module: mod_mqtt
    backlog: 1000

Und lösche den kompletten Block.

Suche nach:

  mod_mqtt: {}

Und lösche die komplette Zeile.

Die Änderungen mit [STRG] + [s] speichern und den Editor mit [STRG] + [x] und [STRG] + [c] verlassen.

$ exit
$ cp /home/ejabberd/opt/ejabberd-22.10/bin/ejabberd.service /etc/systemd/system/ejabberd.service

Damit nicht bei jedem Update die Datei neu kopiert werden muss, passen wir noch die Pfade an.

Konfiguration öffnen:

$ jed /etc/systemd/system/ejabberd.service

Suche nach:

ExecStart=/home/ejabberd/opt/ejabberd-22.10/bin/ejabberdctl foreground
ExecStop=/bin/sh -c '/home/ejabberd/opt/ejabberd-22.10/bin/ejabberdctl stop && /home/ejabberd/opt/ejabberd-22.10/bin/ejabberdctl stopped'
ExecReload=/home/ejabberd/opt/ejabberd-22.10/bin/ejabberdctl reload_config

und ersetze durch:

ExecStart=/home/ejabberd/opt/ejd/bin/ejabberdctl foreground
ExecStop=/bin/sh -c '/home/ejabberd/opt/ejd/bin/ejabberdctl stop && /home/ejabberd/opt/ejd/bin/ejabberdctl stopped'
ExecReload=/home/ejabberd/opt/ejd/bin/ejabberdctl reload_config

Die Änderungen mit [STRG] + [x] und [STRG] + [s] speichern und den Editor mit [STRG] + [x] und [STRG] + [c] verlassen.

Zum Schluss den Dienst aktivieren und starten:

$ systemctl daemon-reload
$ systemctl enable ejabberd.service
$ systemctl start ejabberd.service

$ su - ejabberd
$ ./opt/ejd/bin/ejabberdctl register <benutzer> <beispiel.de> <passwort>

Das wars, du kannst dich jetzt mit einem beliebigen XMPP Client am Server anmelden und direkt loschatten.