Self-Hosting · Kostenfrei

SchulDialogPlus selbst installieren – zwei Wege zum Ziel

Diese Anleitung führt Schritt für Schritt zur eigenen SchulDialogPlus-Instanz – auf zwei Wegen: Die manuelle Installation richtet sich an IT-affine Mitarbeitende mit Grundkenntnissen im Umgang mit einem Terminal. Die Installation mit Cloudron ist der komfortable Weg für alle, die möglichst wenig mit Technik zu tun haben möchten – inklusive automatischer Updates und Backups. Wenn Sie sich unsicher fühlen, übernimmt die plaxon GmbH die Einrichtung gerne als kostenpflichtige Begleitleistung.

Sie sind technischer Laie? Dann ist der Weg über Cloudron die einfachere Wahl.

Was passiert bei der Installation?

Ein einziger Befehl, zwei Eingaben

Sie führen am Ende einen einzigen Befehl aus. Dieser Befehl lädt automatisch alles Nötige aus dem Internet, richtet die Software ein und macht SchulDialogPlus über Ihre Domain (z. B. schuldialog.ihre-schule.de) im Browser erreichbar – inklusive HTTPS-Verschlüsselung. Sie müssen während der Installation nur zwei Angaben machen: Ihre Domain und eine E-Mail-Adresse.

Voraussetzungen

Was Sie vorher brauchen

Bevor Sie beginnen, sollten drei Dinge bereitliegen: ein Server, eine Domain und eine E-Mail-Adresse.

01 · Server

Ein Server im Internet

Ein „Server" ist im Grunde ein Computer, der dauerhaft im Internet läuft. Sie mieten einen solchen Computer bei einem Anbieter („Hoster"). Für DSGVO-Konformität ist ein deutscher oder europäischer Hoster wichtig.

Empfohlene Anbieter (Stand 2026)

  • Hetzner – günstig, sehr beliebt in Deutschland
  • IONOS – Karlsruhe, bekannt aus 1&1
  • Strato – Berlin, Deutsche-Telekom-Tochter
  • netcup – Karlsruhe, günstig

Server-Größe für bis zu 500 Kinder

  • 2 CPU-Kerne (auch „vCPU")
  • 4 GB Arbeitsspeicher (RAM)
  • 40 GB SSD Festplatte
  • Ubuntu 24.04 LTS als Betriebssystem

Bei Hetzner heißt das passende Paket z. B. CX22 und kostet etwa 4–5 € pro Monat.

02 · Domain

Eine eigene Internetadresse

Eine Domain ist die Adresse, unter der Ihre Schule SchulDialogPlus später erreichen wird – zum Beispiel dialog.musterschule.de. Wenn Ihre Schule bereits eine eigene Internetadresse hat, können Sie eine Subdomain dafür einrichten – das ist meistens kostenlos.

Falls Sie noch keine Domain haben: Sie bekommen eine bei jedem der genannten Hoster für etwa 10–20 € pro Jahr.

Notieren Sie sich nach der Bestellung:
  • die IP-Adresse des Servers (z. B. 49.12.214.108)
  • den Benutzernamen (meist root oder ubuntu)
  • das Passwort oder den SSH-Schlüssel
03 · E-Mail

Eine E-Mail-Adresse

Die brauchen Sie für die kostenlosen SSL-Sicherheitszertifikate (sorgen für das Schloss-Symbol im Browser). Es genügt eine ganz normale Adresse, z. B. it@musterschule.de.

An diese Adresse werden ausschließlich Hinweise zu ablaufenden Verschlüsselungs-Zertifikaten verschickt – sehr selten, meist gar nie.

Installation

In vier Schritten zur eigenen Instanz

Folgen Sie der Reihenfolge: DNS-Eintrag setzen, per SSH verbinden, Setup-Script ausführen, im Browser prüfen.

Domain auf den Server zeigen lassen

Damit Ihre Domain auf den Server verweist, müssen Sie einen sogenannten DNS-Eintrag anlegen. Das klingt komplizierter, als es ist.

  1. Loggen Sie sich beim Anbieter Ihrer Domain ein (z. B. bei Strato, IONOS oder dem Hoster, bei dem Sie die Domain registriert haben).
  2. Suchen Sie den Bereich „DNS-Verwaltung", „Domains" oder „Nameserver-Einstellungen".
  3. Legen Sie einen neuen Eintrag an mit folgenden Werten:
    • Typ: A
    • Name (oder „Host"): die Subdomain, z. B. dialog (für dialog.musterschule.de)
    • Wert (oder „Ziel"): die IP-Adresse Ihres Servers, z. B. 49.12.214.108
    • TTL (falls abgefragt): den Standardwert beibehalten
  4. Speichern.
Geduld nötig: Es kann bis zu 30 Minuten dauern, bis dieser Eintrag im Internet sichtbar wird. In dieser Zeit sollten Sie schon einmal mit Schritt 2 fortfahren.

Mit dem Server verbinden

Sie verbinden sich mit Ihrem Server über ein Programm namens SSH („Secure Shell"). Dabei tippen Sie Befehle in ein schwarzes Fenster – das wirkt erstmal ungewohnt, aber Sie geben am Ende nur einen einzigen Befehl ein.

Wenn Sie Windows 10 oder 11 nutzen

  1. Drücken Sie die Windows-Taste und tippen Sie Terminal (oder PowerShell).
  2. Öffnen Sie das gefundene Programm. Es erscheint ein Fenster mit hellem Text auf dunklem Grund.
  3. Tippen Sie diesen Befehl, ersetzen Sie IHRE-SERVER-IP durch die IP-Adresse aus Schritt 1: 
    ssh root@IHRE-SERVER-IP
    Beispiel: ssh root@49.12.214.108
  4. Beim allerersten Verbinden werden Sie gefragt: „Are you sure you want to continue connecting (yes/no)?" – tippen Sie yes und drücken Sie Enter.
  5. Geben Sie Ihr Server-Passwort ein. Wichtig: Während Sie tippen, sehen Sie nichts auf dem Bildschirm – keine Sternchen, keine Punkte. Das ist normal und gewollt. Tippen Sie das Passwort blind und drücken Sie Enter.

Wenn Sie macOS nutzen

  1. Öffnen Sie das Programm Terminal (über Spotlight: ⌘ + Leertaste, dann Terminal eintippen).
  2. Geben Sie denselben Befehl wie oben ein: 
    ssh root@IHRE-SERVER-IP
  3. Bei der Frage (yes/no)? tippen Sie yes. Dann das Passwort blind eingeben.
Wenn Sie eine Begrüßungsmeldung Ihres Servers sehen (etwas wie „Welcome to Ubuntu 24.04 LTS"), sind Sie verbunden. Sie haben es geschafft.

Das Setup-Script ausführen

Sie sind jetzt auf dem Server. Tippen Sie nacheinander folgende drei Befehle und drücken Sie nach jedem Enter.

Befehl 1 – Setup-Script herunterladen

curl -fsSLO https://www.schuldialogplus.de/setup.sh

Das lädt die Installationsdatei auf den Server. Wenn alles geklappt hat, kommt einfach die nächste Eingabezeile zurück, ohne weitere Meldung.

Befehl 2 (optional, empfohlen) – Datei kurz anschauen

Aus Sicherheitsgründen ist es eine gute Angewohnheit, einen kurzen Blick in die heruntergeladene Datei zu werfen, bevor Sie sie ausführen:

less setup.sh

Sie können mit den Pfeiltasten scrollen und mit der Taste q (für quit) wieder herauskommen. Sie müssen den Inhalt nicht verstehen – der Schritt soll nur sichergehen, dass tatsächlich ein Bash-Script da steht und keine offensichtliche Fehlermeldung.

Befehl 3 – Setup starten

sudo bash setup.sh

Jetzt geht's los. Das Script wird Ihnen zwei Fragen stellen:

  1. „Domain unter der die App erreichbar sein soll" – Geben Sie Ihre vollständige Domain ein, z. B. dialog.musterschule.de (ohne https:// davor).
  2. „E-Mail-Adresse für Let's-Encrypt-Zertifikate" – Ihre E-Mail, z. B. it@musterschule.de.

Danach läuft die Installation vollautomatisch. Auf dem Bildschirm erscheinen viele Meldungen – das ist normal. Der gesamte Vorgang dauert je nach Internetgeschwindigkeit Ihres Servers 5 bis 15 Minuten. Lehnen Sie sich zurück.

Am Ende sehen Sie einen grünen Kasten mit der Meldung „Setup abgeschlossen" und der Adresse, unter der SchulDialogPlus jetzt erreichbar ist.

Erste Nutzung im Browser

Öffnen Sie einen Webbrowser (Chrome, Firefox, Edge, Safari) und geben Sie Ihre Domain mit https:// davor ein:

https://dialog.musterschule.de

Wenn Sie das Schloss-Symbol in der Adresszeile sehen, ist die Verbindung verschlüsselt und alles ist korrekt eingerichtet.

Falls die Seite nicht sofort lädt: Warten Sie 2–3 Minuten und probieren Sie es erneut. Die Verschlüsselungs-Zertifikate werden beim ersten Aufruf erzeugt, und das dauert einen Moment.

Nächster Schritt

Portal jetzt einrichten

Mit der laufenden Instanz im Browser geht es weiter zur Grundkonfiguration: In sieben kurzen Schritten richten Sie Admin-Passwort, Datenschutzstufe, E-Mail-Versand, optionale KI-Anbindung und Verschlüsselungskey ein.

Weiter zum Schnelleinstieg
Wenn etwas nicht klappt

Typische Probleme und Lösungen

Die häufigsten Stolperfallen während der Installation – und was Sie dagegen tun können.

„Die Seite kann nicht erreicht werden" / „Server-IP konnte nicht gefunden werden"

Der DNS-Eintrag aus Schritt 1 ist noch nicht aktiv. Warten Sie 15–30 Minuten und versuchen Sie es erneut. Sie können auf whatsmydns.net prüfen, ob Ihre Domain bereits weltweit auf die richtige IP zeigt.

„Permission denied" beim SSH-Verbinden

Das Passwort wurde falsch eingegeben. Achten Sie auf Groß-/Kleinschreibung und tippen Sie es nochmal in Ruhe. Auch wenn Sie keine Sternchen sehen – das Passwort kommt an.

„Ungültige Domain" oder „Ungültige E-Mail" während des Setups

Sie haben sich vertippt. Geben Sie die Werte nochmal sauber ein. Die Domain darf kein https:// und kein / enthalten – nur Buchstaben, Zahlen, Punkte und Bindestriche.

Der Browser warnt vor einer „unsicheren Verbindung"

Die Verschlüsselungs-Zertifikate sind noch nicht fertig eingerichtet. Warten Sie ein paar Minuten und laden Sie die Seite neu (F5 / ⌘+R). Falls das Problem nach 10 Minuten noch besteht, verbinden Sie sich erneut per SSH und geben Sie ein:

cd SchulDialogPlus
docker compose logs traefik | grep -i acme

Die Ausgabe enthält Hinweise, was schiefgegangen ist (häufig: DNS-Eintrag noch nicht weltweit aktiv).

Sie wollen das Setup nochmal von vorn ausführen

Auf dem Server eingeben:

cd SchulDialogPlus
sudo bash ../setup.sh --uninstall
cd ..
sudo rm -rf SchulDialogPlus

Damit ist alles entfernt und Sie können Schritt 3 erneut ausführen.

Im laufenden Betrieb

Wartung im Alltag

Sie müssen sich um den laufenden Betrieb fast nicht kümmern. Die Software startet sich nach Neustarts des Servers automatisch und holt sich Sicherheits-Zertifikate selbstständig.

Etwa alle 1–2 Monate sollten Sie Updates einspielen. Dazu auf dem Server:

cd SchulDialogPlus
sudo docker compose pull
sudo docker compose up -d
Diese drei Befehle laden die neueste Version von SchulDialogPlus und starten sie. Das dauert ein bis zwei Minuten und Ihre Daten bleiben dabei vollständig erhalten.

Sie kommen nicht weiter?

Wenn Sie an einem Punkt stecken bleiben, sind wir gerne für Sie da. Halten Sie für Ihre Anfrage bitte folgende Angaben bereit: Ihre Domain, den Hoster und das Server-Paket, das Sie nutzen, sowie die genaue Fehlermeldung (am besten als Screenshot oder kopiert).

Kontakt aufnehmen