Einrichtung
Diese Anleitung führt Sie Schritt für Schritt durch die Installation der edulution Plattform.
Inhaltsverzeichnis
- curl installieren
- Installationsprogramm starten
- Web-Installer aufrufen
- Setup-Token eingeben
- Daten konfigurieren
- SSL-Zertifikat einrichten
- Verbindungstest
- Installation abschließen
1. curl installieren
Um das Installationsprogramm herunterzuladen wird das Programm curl
benötigt. Dieses kann über folgenden Befehl installiert werden:
apt-get update && apt-get -y install curl
2. Installationsprogramm starten
Nun kann das Installationsprogramm gestartet werden. Der Link hierzu kann unter https://get.edulution.io abgerufen werden.
bash <(curl -s https://get.edulution.io/installer)
Als Erstes fragt das Installationsprogramm nach der Domain, unter der die edulution Plattform erreichbar sein soll:
Domain für edulution (leer lassen zum Überspringen):
In Schritt 5 trägt der Web-Installer sie als Externe Domain der edulution Plattform ein. Geben Sie die Domain auch an, wenn der DNS-Eintrag noch fehlt: Die anschließende DNS-Prüfung warnt nur, die Installation läuft weiter. Hat der Server noch keine Domain, überspringen Sie die Frage und tragen die Adresse in Schritt 5 ein, auch als IP-Adresse.
Ohne Terminal oder im Hintergrund fragt das Installationsprogramm nicht nach. Geben Sie die Domain dann beim Aufruf mit:
bash <(curl -s https://get.edulution.io/installer) --domain ui.musterschule.de
3. Web-Installer starten
Das Installationsprogramm startet und installiert alle benötigten Pakete. Sobald folgende Meldung erscheint, geht es weiter:
[*] Starte den edulution Web-Installer...
########################################################
edulution Web-Installer
Sie erreichen die Oberfläche wie folgt:
https://ui.musterschule.de/?token=3f9c2a…
https://ui01.musterschule.lan:443/?token=3f9c2a…
https://10.0.0.5:443/?token=3f9c2a…
Anleitung zur Installation: https://docs.edulution.io/docs/edulution-plattform/installation/einrichtung/
########################################################
Die erste Zeile mit der Domain erscheint nur, wenn Sie beim Start eine Domain angegeben haben. Sonst steht unter „Über einen DNS-Namen, der auf diesen Server zeigt:“ der Link https://<domain>/?token=…. Ersetzen Sie darin <domain>, wenn Sie den Web-Installer über einen solchen Namen aufrufen möchten.
Öffnen Sie einen der Links im Browser und übernehmen Sie ihn vollständig. Er enthält einen Zugangsschlüssel (?token=…), der nichts mit dem Setup-Token im nächsten Schritt zu tun hat.
Nach dem ersten Aufruf merkt sich der Browser den Zugang, bis Sie ihn schließen, und der Schlüssel verschwindet aus der Adresszeile. Für einen weiteren Browser kopieren Sie deshalb den Link aus der Konsole, nicht aus der Adresszeile. Nach einem Neustart des Installationsprogramms gilt nur der neu ausgegebene Link.
Ohne gültigen Schlüssel zeigt der Web-Installer nur den Hinweis „Bitte öffnen Sie den Link, den das Installationsskript in der Konsole ausgibt.“
4. Setup-Token
Im ersten Schritt kann das Edulution-Setup-Token oder über "Manuell eingeben" die Daten manuell eingegeben werden.
Ist der Edulution-Setup-Token gültig, wird der Button "Überprüfen" aktiviert und die Daten können auf der nächsten Seite überprüft werden.
5. Daten konfigurieren
Hier sollten die Daten auf Richtigkeit geprüft bzw. manuell eingegeben werden.
- Für LDAPS zu einem bestehenden Linuxmuster-Server gelten schon in diesem Schritt die Angaben unter Verbindung zum Linuxmuster-Server per LDAPS.
- Unter "Externe Domain der edulution Plattform" muss die Domain stehen, unter der die edulution Plattform erreichbar ist. Der Zugriff von einer anderen Domain aus ist nicht möglich!
6. SSL-Zertifikat Konfiguration
Nach der Grundkonfiguration werden Sie nach der SSL-Zertifikat Einrichtung gefragt.
Falls Ihre edulution Plattform hinter einem Reverse-Proxy betrieben wird, der bereits SSL-Terminierung übernimmt, können Sie diesen Schritt überspringen.
Sie haben folgende Optionen:
- Let's Encrypt (empfohlen für öffentliche Domains): siehe Let's Encrypt einrichten
- Selbstsigniertes Zertifikat (für Testumgebungen):
- Lassen Sie das Feld leer oder klicken Sie auf "Selbstsigniertes Zertifikat erstellen"
- Sie werden nach folgenden Informationen gefragt:
- Ländercode (z.B. DE)
- Bundesland/Provinz
- Stadt
- Organisation
- Gültigkeitsdauer in Tagen (Standard: 365)
- Eigenes Zertifikat hochladen (für vorhandene Zertifikate):
- Laden Sie Ihr Zertifikat (.crt, .pem, .cer, .cert) und den privaten Schlüssel (.key, .pem) hoch
- Stellen Sie sicher, dass die Zertifikate im korrekten Format vorliegen
Reverse-Proxy Erkennung: Das System erkennt automatisch, ob es hinter einem Reverse-Proxy läuft. In diesem Fall wird die SSL-Konfiguration übersprungen.
Let's Encrypt einrichten
Der Installer bezieht ein Zertifikat für die externe Domain und alle
ihre Subdomains (*.ui.musterschule.de). Let's Encrypt prüft dabei nicht
den Server, sondern einen DNS-Eintrag: Die Domain wird beim ACME-DNS-Dienst
von Netzint registriert, über den Traefik die Prüfung abwickelt. Der Server
muss dafür nicht aus dem Internet erreichbar sein, braucht aber einige
ausgehende Verbindungen.
-
Wählen Sie Zertifikat mit Let's Encrypt erstellen.
-
Geben Sie unter E-Mail-Adresse eine Kontaktadresse für das Let's-Encrypt-Konto ein und wählen Sie Zertifikat erstellen.
-
Legen Sie bei Ihrem DNS-Anbieter den CNAME-Eintrag an, den der Installer nach „ACME-DNS Registrierung erfolgreich“ anzeigt:
Name Typ Ziel _acme-challenge.<externe Domain>CNAME Wert unter Fulldomain -
Wählen Sie CNAME-Eintrag prüfen, sobald der Eintrag beim DNS-Anbieter gespeichert ist.
Für die Prüfung fragt der Installer Cloudflare und Google per DNS-over-HTTPS.
| Meldung | Ursache | Abhilfe |
|---|---|---|
| „Noch kein passender CNAME-Eintrag gefunden. Änderungen im DNS können einige Minuten brauchen.“ | Der Eintrag fehlt oder ist noch nicht sichtbar. Steht dahinter „Gefunden: …“, zeigt er auf ein anderes Ziel. Wurde vor dem Anlegen geprüft, halten Cloudflare und Google die leere Antwort je nach Zone mehrere Stunden vor. | Eintrag beim DNS-Anbieter prüfen und nach einigen Minuten erneut prüfen |
| „Der CNAME-Eintrag ließ sich nicht prüfen, weil weder Cloudflare noch Google per DNS-over-HTTPS erreichbar sind.“ | Ausgehendes HTTPS zu beiden ist gesperrt. | Ausgehende Verbindungen freigeben oder ohne Prüfung fortfahren (siehe unten) |
Lässt sich der Eintrag nicht rechtzeitig anlegen oder prüfen, aktivieren Sie
Ohne geprüften CNAME-Eintrag fortfahren. Legen Sie den Eintrag später an
und starten Sie Traefik neu (docker restart edulution-traefik), damit es das
Zertifikat bezieht.
Wählen Sie Zertifikat erstellen ein weiteres Mal, bleibt die Registrierung beim ACME-DNS-Dienst dieselbe, und ein bereits angelegter CNAME-Eintrag gilt weiter.
Traefik erneuert das Zertifikat vor Ablauf selbst. Dafür muss der CNAME-Eintrag dauerhaft bestehen bleiben.
Der Installer prüft den CNAME-Eintrag, aber nicht das ausgestellte Zertifikat. Rufen Sie nach Abschluss der Installation die externe Domain im Browser auf und sehen Sie nach, ob er ein Zertifikat von Let's Encrypt zeigt. Meldet er eine unsichere Verbindung, hilft die Fehlerbehebung.
Placeholder für SSL-Konfiguration Screenshot
Hier wird der Screenshot des SSL-Konfigurationsschritts eingefügt, sobald verfügbar.
7. Verbindungstest
Anschließend wird der Zugriff auf die Linuxmuster-WebUI (Port 443), die Linuxmuster-API (Port 8001) und der Zugriff sowie die Anmeldung am LDAP-Server getestet. Sind alle Tests bestanden, kann die Installation abgeschlossen werden.
8. Installation abschließen
Erscheint in der Konsole folgender Text, ist die Installation abgeschlossen und die edulution Plattform kann verwendet werden!
########################################################____ _ _ _ _ _ _/ ___| (_) (_) ___| | ____ ___ _ _ __ ___ ___| |__ | || | _| | | | |/ __| |/ /\ \ /\ / / | | | '_ \/ __|/ __| '_ \| || |_| | | |_| | (__| < \ V V /| |_| | | | \__ \ (__| | | |_|\____|_|\__,_|\___|_|\_\ \_/\_/ \__,_|_| |_|___/\___|_| |_(_)Die Installation der edulution Plattform ist abgeschlossen!Sie erreichen die Oberfläche wie folgt:https://ui01:443https://10.0.0.5:443########################################################
Hat der Web-Installer den Linuxmuster-Server auf demselben Server eingerichtet, folgt auf diese Ausgabe noch:
[!] Bitte starten Sie den Server jetzt neu, damit alle Änderungen wirksam werden: sudo reboot
Starten Sie den Server erst dann neu. Ein früherer Neustart bricht die edulution-Installation ab.
Richtet der Web-Installer den Linuxmuster-Server ein, erzeugt dessen Setup neue
SSH-Host-Schlüssel. Notieren Sie die Fingerprints unter „New SSH host keys“ am
Ende des Protokolls, solange der Web-Installer es anzeigt. Beim nächsten
SSH-Login meldet der SSH-Client einmalig „REMOTE HOST IDENTIFICATION HAS
CHANGED“. Stimmt der Fingerprint, entfernen Sie den alten Eintrag mit
ssh-keygen -R <Name oder IP-Adresse des Servers>.
Diese Seite richtet sich an eine andere Zielgruppe
Sie ist geschrieben für: Admin · Einrichtung. Ihre aktuelle Auswahl blendet sie deshalb aus.