DE / EN
SELF-HOSTING GUIDE

LXBG auf dem eigenen Server installieren

Die Grundarchitektur besteht aus Web-App/Datenbank, LXBGIRCd, Auth-Bridge, WebSocket-Bridge und – je nach Paket – LXBG Services. Diese Anleitung beschreibt den dokumentierten Community-Edition-Workflow.

Empfohlen: Debian 12, öffentliche IPv4, Domain mit TLS, PHP 8.2+, MariaDB/MySQL, Python 3 und systemd. Vor Änderungen am Server immer ein Backup erstellen.
NEU · LXBG CORE FREE 1.3 MODERN · BETA

Installation mit dem neuen Web-Assistenten

Im neuen LXBG Core Free 1.3 Modern liegt die vollständige Installationsanleitung INSTALLATION-DE.md direkt im ZIP, zusätzlich eine Schnellstart-Datei INSTALLIEREN-ZUERST-LESEN.txt. Der Web-Assistent zeigt vor der Einrichtung eine Systemprüfung und legt anschließend Datenbanktabellen sowie den ersten Administrator an.

  1. Neues Gratis-ZIP von Downloads → LXBG Core Free Modern herunterladen und entpacken.
  2. Domain/HTTPS einrichten; ausschließlich web/ als öffentlichen Webroot verwenden.
  3. Eine neue leere MySQL/MariaDB-Datenbank mit eigenem Benutzer anlegen.
  4. Im Browser https://DEINE-DOMAIN/setup.php öffnen. Systemprüfung kontrollieren, Zugangsdaten, Admin-Konto und IRC-Hostnamen eintragen.
  5. Nach Erfolg web/setup.php entfernen und unter /admin/index.php anmelden.
  6. IRC-Daemon, Auth-Bridge, LXBG Services und TLS danach gemäß INSTALLATION-DE.md mit Serveradministrator-/Hosterrechten einrichten und testen.
Wichtig: Der Web-Installer ersetzt noch keine Linux-Diensteinrichtung. Die kostenlose 1.3 ist eine BETA; zunächst auf einem Testserver installieren. Die ältere Anleitung weiter unten bezieht sich auf die Community Edition 1.1.

Core Free Modern BETA herunterladen → Änderungen / Changelog →

1 · Paket herunterladen und entpacken

Lade die Community Edition bzw. die Komponenten über die Downloadseite herunter und entpacke sie zunächst in ein Arbeitsverzeichnis. Führe Installationsskripte nur aus Paketen aus, die du direkt von LXBG bezogen hast.

unzip LXBG-Community-Edition-1.1.zip
cd LXBG-Community-Edition-1.1
sudo ./install.sh

Der Installer kopiert die Community Edition standardmäßig nach /opt/lxbg-ce, legt den Systembenutzer lxbg an und bereitet Laufzeitverzeichnisse vor. Öffentliche Dienste werden absichtlich nicht ungeprüft automatisch gestartet.

2 · Datenbank konfigurieren

Erstelle eine eigene UTF-8-MariaDB/MySQL-Datenbank und einen dedizierten Benutzer. Importiere anschließend die mitgelieferte schema.sql. Kopiere config.example.json nach config.json, trage Datenbankzugang und IRC-Hostname ein und schütze die Datei mit Dateirechten 600. Zugangsdaten gehören nicht in den öffentlichen Webroot.

3 · Web-App bereitstellen

Stelle das mitgelieferte Web-Verzeichnis mit PHP 8.2+ über nginx oder Apache bereit und verwende HTTPS. Passe den privaten Datenbank-/Bootstrap-Pfad an deine Serverstruktur an. Domain, TLS-Zertifikat und Webroot unterscheiden sich je nach Hosting und werden deshalb nicht automatisch geraten.

4 · Auth-Bridge aktivieren

Die Auth-Bridge verbindet den IRC-Daemon mit der LXBG-Accountbasis. Verwende die mitgelieferte lxbg-auth.service.example als systemd-Vorlage. Standardmäßig nutzt sie /run/lxbg-ce/auth.sock und /opt/lxbg-ce/config.json.

5 · LXBGIRCd starten

Prüfe in der mitgelieferten lxbg-ircd.service.example insbesondere Servername, Ports sowie Pfade zum TLS-Zertifikat und privaten Schlüssel. Erst danach die Unit nach /etc/systemd/system/lxbg-ircd.service übernehmen und aktivieren.

sudo systemctl daemon-reload
sudo systemctl enable --now lxbg-auth
sudo systemctl enable --now lxbg-ircd
sudo systemctl status lxbg-auth lxbg-ircd

Standardmäßig sind im Beispiel IRC auf Port 6667 und IRC/TLS auf 6697 vorgesehen. Mit einem IRC-Client kannst du anschließend /VERSION testen; LXBGIRCd 1.0 sollte antworten.

6 · Browser/WebSocket-Bridge

Für den Browserchat läuft die mitgelieferte WebSocket-Bridge lokal (Beispiel: 127.0.0.1:8000). Aktiviere die lxbg-ws.service-Vorlage und reverse-proxy den öffentlichen Pfad /irc-ws/ über nginx/Apache mit WebSocket-Upgrade-Headern. Die lokale Bridge sollte nicht unnötig direkt ins Internet exponiert werden.

sudo systemctl enable --now lxbg-ws
sudo systemctl status lxbg-ws

7 · LXBG Services 1.1 installieren

Entpacke LXBG-Services-1.1.zip, importiere schema.sql und installiere pymysql sowie argon2-cffi. Kopiere anschließend config.example.json nach /etc/lxbg-services/config.json und trage Datenbank, Server-ID, IRC-Uplink und Link-Passwort ein. Starte danach services/daemon.py; bei Verwendung der LXBG-Webseite zusätzlich services/auth_bridge.py.

python3 services/daemon.py --config /etc/lxbg-services/config.json --db-test
python3 services/daemon.py --config /etc/lxbg-services/config.json
Wichtig seit 1.1: LXBG Services sind unsere eigene Services-Schicht. LXBG Account Services, LXBG Channel Services und SASL gehören zur Basis. LXBG Services 1.1 verwaltet Accounts, Channel-Rechte und SASL eigenständig. Für den Uplink müssen Server-ID, Link-Passwort und IRCd-Link-Konfiguration zusammenpassen.

8 · Neustart und Funktionstest

sudo systemctl status lxbg-auth lxbg-ircd lxbg-ws
sudo journalctl -u lxbg-ircd -n 50 --no-pager

Teste danach HTTPS, Registrierung/Login, IRC-Verbindung über TLS, Browserchat und – sofern installiert – LXBG Account Services/LXBG Channel Services. Premium-Module besitzen zusätzlich ihre eigene README/Installationsanleitung.

Installation lieber komplett abgeben?

JKWEB übernimmt die LXBG-Grundinstallation auf einem kompatiblen Linux-Server für 149,00 € einmalig. Server, Domain und individuelle Sonderentwicklung sind nicht enthalten.

Installation anfragen → Zurück zu Downloads