School Server einrichten

Für Schul-IT, Schulträger und die Lehrkraft, die Kinhavn an der Schule betreut: von der Hardware über den Datenschutz bis zur ersten Unterrichtsstunde.

Vorab-Beta. Die Installation richtet sich heute an Pilotfamilien und Pilotschulen mit etwas Technikerfahrung. Den Zugang zum Installationspaket (Git-Adresse oder ZIP-Datei) und eine Lizenz bekommen Sie von uns. Ein fertiges Abbild zum Aufspielen, ohne Kommandozeile, ist in Vorbereitung.

Stand Oktober 2026. Der School Server ist in der Pilotvorbereitung. Einrichtungsassistent, Kopplung persönlicher Geräte und Anmeldung bei der Zentrale werden gerade fertiggestellt. Pilotschulen richten wir gemeinsam ein; diese Anleitung beschreibt den Ablauf, wie er für den Start vorgesehen ist.

1 Planung und Datenschutz

Zweck festlegen: KI zum Lernen und Erklären, keine Benotung, keine Prüfungsaufsicht. Das steht so auch in der Dokumentation des Produkts.
Datenschutz-Folgenabschätzung mit der oder dem Datenschutzbeauftragten der Schule. Wir liefern Vorlage und technische Beschreibung. Wichtig für die Bewertung: Alle Daten und Modelle bleiben im Schulnetz; die Zentrale erhält keine Schülerdaten.
Rollen besetzen: Schul-Admin, Schul-IT, Vertrauenslehrkraft oder Schulsozialarbeit (für Krisenhinweise), erste Lehrkräfte.
Eltern informieren: Was die Schule mit Kinhavn tut und was sie sieht. Elternbeiträge gibt es nicht.

2 Hardware

gleichzeitig aktive Schüler·innen	Richtwert
bis 30 (eine Klasse)	ein Rechner mit einer Grafikkarte ab 24 GB Videospeicher, 64 GB Arbeitsspeicher
30–100	ein Server mit zwei bis vier Grafikkarten oder mehrere Workstations hinter dem Gateway des School Servers
über 100 oder mehrere Schulen	Server mit vier bis acht Grafikkarten beim Schulträger; je Schule ein eigener Mandant

Die Warteschlange fängt Spitzen ab: Eine Anfrage wartet höchstens 60 Sekunden; dann antwortet ein kleineres lokales Modell, wenn eines eingerichtet ist, sonst kommt ein freundlicher Hinweis.

3 Installation

Software wie beim Home Server (Git, Node.js, Docker, Ollama), dann Kinhavn holen, bauen und Modelle laden:

cd C:\
git clone <GIT-ADRESSE-AUS-IHRER-EINLADUNG> Kinhavn
cd C:\Kinhavn
npm ci
npm run build
ollama pull qwen3.8:27b
ollama pull qwen3.5:4b          # kleineres Modell für die Lastspitze
ollama pull llama-guard3:1b
docker compose -f docker\searxng\docker-compose.yml up -d

Für Schulen empfehlen wir SQL Server statt Dateien:

cd C:\Kinhavn
# SQL Server im Container; für den Schulbetrieb die kostenlose Express-Edition
Copy-Item docker\mssql\.env.example docker\mssql\.env
notepad docker\mssql\.env          # MSSQL_SA_PASSWORD setzen (12+ Zeichen, gemischt)
# Edition Express statt Developer (Developer ist nur für Entwicklung lizenziert)
Set-Content docker\mssql\docker-compose.express.yml "services:`n  mssql:`n    environment:`n      MSSQL_PID: Express"
docker compose -f docker\mssql\docker-compose.yml -f docker\mssql\docker-compose.express.yml up -d
npm run db:init -w @kinhavn/school-server

4 Konfiguration

Copy-Item packages\school-server\.env.example packages\school-server\.env
notepad packages\school-server\.env

PORT=4530
SESSION_SECRET=<zufällige Zeichenkette, siehe Home Server>
PERSISTENCE=mssql
MSSQL_HOST=localhost
MSSQL_PORT=1433
MSSQL_DATABASE=KinhavnSchool
MSSQL_USER=kinhavn_school
# Hauptmodell auf dem GPU-Server
OLLAMA_BASE_URL=http://127.0.0.1:11434
OLLAMA_MODEL=qwen3.8:27b
# Zweiter GPU-Rechner (optional)
OLLAMA_NODE_BASE_URL=http://<gpu-rechner>:11434
OLLAMA_NODE_MODEL=qwen3.5:9b
OLLAMA_NODE_LABEL=GPU-Rechner Raum 112
POLICY_GUARD_MODEL=llama-guard3:1b
POLICY_GUARD_BASE_URL=http://127.0.0.1:11434
SEARXNG_BASE_URL=http://127.0.0.1:5780

Der School Server bietet nur lokale Modelle an. Anbieter im Internet sind im Schulkontext nicht vorgesehen; eine Schule, die das will, muss das selbst vertraglich und datenschutzrechtlich lösen.

# Firewall: nur aus dem Schulnetz (Bereich anpassen)
New-NetFirewallRule -DisplayName "Kinhavn School Server" -Direction Inbound -Protocol TCP -LocalPort 4530 -RemoteAddress 10.0.0.0/8 -Action Allow
npm run start -w @kinhavn/school-server

5 Einrichtung

Einrichtungstoken aus der Ausgabe nehmen und http://localhost:4530 öffnen.
Erstes Konto: Schul-Admin der Schule oder, bei einem Schulträger, die Schul-IT des Trägers. Für beide ist der zweite Faktor Pflicht.
Erste Schule (Name), Sprache, Zeitzone, Altersband-Schema (Vorgabe Kinhavn A–E), lokale Modelle.
Wiederherstellungscode mit 24 Wörtern aufschreiben und sicher verwahren (Tresor der Schule).
Die Schul-IT eines Trägers legt weitere Schulen an und lädt für jede den ersten Schul-Admin ein. Sie sieht danach die Technik aller Schulen, aber keine Personen und keine Inhalte.
Schuljahr anlegen, Fächer mit Fachvorlage (wie der Assistent im Fach arbeiten soll), Personal einladen.

6 Schülerinnen und Schüler importieren

Exportieren Sie aus der Schulverwaltung eine CSV-Datei mit Kopfzeile, getrennt durch Semikolon oder Komma. Das Geburtsdatum bestimmt die Altersstufe; fehlt es, gilt die strengste Stufe, bis es nachgetragen ist.

Vorname;Nachname;Klasse;Geburtsdatum
Mia;Beispiel;7b;14.03.2013
Jonas;Muster;7b;2013-09-02
Ela;Probe;Q1;02.11.2009

Der Import zeigt zuerst einen Probelauf mit Fehlern und Dubletten; erst danach legt er an. Klassen, die es noch nicht gibt, kann er mit anlegen. Jede Schülerin und jeder Schüler bekommt eine vierstellige PIN.

7 Klassen, Kurse, AGs

Art	Mitglieder	Beispiel
Klasse-Fach	folgen der Klasse	Mathematik 7b
Kurs	aus mehreren Klassen, von der Lehrkraft verwaltet	Informatik Q1, Wahlpflicht Spanisch
AG	aus mehreren Klassen und Stufen, Fach optional	Robotik-AG

Schülerinnen und Schüler chatten nur in ihren Lerngruppen: Jede Anfrage trägt die Anweisung des Fachs, den Anteil am Budget und die Einsichtsregel der Schule. Mitgliederlisten sehen sie nie.

8 Geräte und Anmeldung

Geteilte Geräte (Tablet-Koffer, Computerraum): mit dem Klassencode koppeln, gültig 180 Tage. Danach zeigt das Gerät die Auswahl der Klasse; Anmeldung mit PIN.
Persönliche Geräte: Die Lehrkraft erzeugt für eine Schülerin oder einen Schüler einen persönlichen Kopplungscode (zehn Minuten). Das Gerät kann zugleich mit dem Home Server der Familie verbunden sein; die App hält beides getrennt.
Personal: Anmeldung mit Passwort; zweiter Faktor für Admin und Schul-IT Pflicht, für Lehrkräfte nach Entscheidung der Schule.

9 Regeln, Budgets, Werkstatt

Schulregeln: erlaubte Modelle, Websuche, Bilder, was Lehrkräfte sehen (Vorgabe: Markierungen und Chats, die Schüler·innen teilen). Fach- und Gruppenregeln können nur weiter einschränken.
Budgets: Der Schul-Admin legt einen Topf je Woche, Monat oder Halbjahr in Minuten und Tokens fest und verteilt ihn auf die Lerngruppen; die Lehrkraft verteilt den Anteil ihrer Gruppe, gleichmäßig als Vorgabe.
KI-Werkstatt: Die Lehrkraft schaltet sie je Lerngruppe ein und wählt die Bausteine. Connectoren gibt es nur aus der Liste, die Schul-Admin oder Schul-IT freigegeben haben.
Pausen: Eine Lehrkraft kann einzelne Schüler·innen in ihrer Gruppe für bis zu 14 Tage pausieren.

10 Krisenhinweise

Erkennt die Policy-Schicht ein Krisensignal, geht sofort ein Hinweis an die Vertrauenslehrkraft oder Schulsozialarbeit (ersatzweise an den Schul-Admin), ohne Textauszug in der Benachrichtigung. Die Belege sehen sie im School Server. Die Eltern informiert die Schule nach ihrem eigenen Verfahren.

11 Betrieb, Sicherung, Zentrale

Dauerbetrieb: als geplante Aufgabe wie beim Home Server (Port 4530, Paket @kinhavn/school-server) oder unter Linux als systemd-Dienst.
Sicherung: jede Nacht um 03:00 Uhr, sieben Stände, verschlüsselt mit dem Wiederherstellungscode; dazu die übliche Sicherung des SQL Servers durch die Schul-IT.
Zentrale (freiwillig): Mit dem Aktivierungscode der Schullizenz anmelden; dann wöchentlich eine versiegelte Kopie außer Haus und Anzeige des Update-Stands.
Wartungsfenster eintragen, damit Schüler·innen statt eines Fehlers einen Hinweis mit dem Ende der Wartung sehen.
Updates: wie beim Home Server, außerhalb der Unterrichtszeit.

Fragen zur Einrichtung: Kontakt.