Mission 13.3 Fehlerfall Lokal & souverän ICT & Infrastruktur

Der lokale Server

Ihr Modell bekommt ein Funkgerät: den lokalen Server von LM Studio. Sie funken es an, ORBIT sabotiert – und Sie bauen eine Diagnosekarte für jede Panne.

Dauer
ca. 45 Min.
Belohnung
100 XP + bis 100 Bonus
Gerät
Laptop mit Installation
Kosten
Lokal & gratis
Anspruch
Analysieren

Funkspruch von ORBIT

ORBIT meldet: Ihr Modell kann reden – aber nur in seinem eigenen Fenster. Das ist, als hätte man eine Funkerin ohne Funkgerät. Heute schalten wir den lokalen Server ein. Dann können andere Programme mit dem Modell sprechen, und bald auch Ihre eigene Webseite.

Ich gestehe vorab: Ich werde sabotieren. Falscher Port, Tippfehler, abgeschaltete Schalter. Nicht aus Bosheit, sondern weil Sie jeden Fehler einmal gesehen haben sollten, bevor er Sie an einem Montagmorgen vor der Klasse erwischt.

01 Ihr Produkt

Ein laufender lokaler Server mit bestandenem Funktest und Ihre Diagnosekarte: sieben Fehlerbilder mit Ursache und Massnahme, plus Ihre eigenen – zum Aufhängen neben dem Laptop oder zum Weitergeben im Kollegium.

Abnahme: Der Server antwortet auf /v1/models und auf eine Chat-Anfrage aus dem Terminal, Sie haben mindestens drei Sabotagen selbst ausgelöst und ihre Symptome notiert, und Ihre Diagnosekarte erklärt den Unterschied «Terminal klappt, Webseite nicht».

Nach dieser Mission können Sie …

  • den lokalen Server von LM Studio starten und über /v1/models und /v1/chat/completions ansprechen
  • in einer Chat-Anfrage die Teile model, messages (system, user) und temperature erklären
  • typische Fehlerbilder (Server aus, falscher Port, falscher Pfad, CORS aus) an ihrem Symptom erkennen
  • begründen, warum «Serve on Local Network» nur mit Authentifizierung eingeschaltet werden darf

Darum geht’s

Solange Ihr Modell nur im Chatfenster von LM Studio lebt, ist es ein schönes Spielzeug. Mit dem lokalen Server wird es zu einem Baustein: Jedes Programm auf Ihrem Gerät kann ihm Fragen schicken – ein Skript, eine Tabelle, und in der nächsten Mission Ihre eigene Webseite. Das ist dieselbe Technik, mit der grosse Anbieter ihre Modelle anbieten, nur dass hier alles auf Ihrem Laptop bleibt.

Vormachen: Eine Diagnose in drei Zügen

Eine Kollegin aus der Logistik meldet: «Mein Funktest geht nicht. Da steht Connection refused.»

  1. Läuft der Server? Im Reiter Developer: ja, Schalter an.
  2. Stimmt die Adresse? LM Studio zeigt Port 1235 an – sie hat ihn letzte Woche geändert und vergessen. Der Funktest fragt aber 1234.
  3. Lösung: BASIS=http://localhost:1235/v1 bash funktest.sh – und die Funkerin meldet sich.

Am nächsten Tag: Funktest klappt, aber ihre Webseite zeigt «Failed to fetch». Gleiche Ursache? Nein. Das Terminal fragt nie nach CORS, der Browser schon. Ein Klick auf «Enable CORS», Seite neu laden, fertig. Zwei Symptome, die ähnlich klingen, zwei völlig verschiedene Ursachen – genau dafür ist die Diagnosekarte da.

Wann ich nicht die KI frage

Eine KI kann Fehlermeldungen wunderbar übersetzen. Ob Sie aber «Serve on Local Network» im Schulnetz einschalten oder Sicherheitseinstellungen von Windows dauerhaft ändern, entscheidet die ICT-Abteilung – nicht der Chat.

02 Bordcheck

Datenampel: Grün – Unbedenklich

Sie schicken nur Testfragen an ein Modell auf Ihrem eigenen Gerät. Der Server ist standardmässig nur auf diesem Gerät erreichbar. Personendaten braucht es nicht.

Werkzeuge

Klappt nicht? Mit Ollama heisst die Adresse http://localhost:11434/v1 (öffnet neues Fenster) (OpenAI-kompatibel), mit Jan steht sie in den Einstellungen der App. Die Funktest-Skripte nehmen eine andere Adresse an (siehe Kommentare). Ohne lauffähiges Modell: Arbeiten Sie die Diagnosekarte mit den Fehlerbildern durch – das ist der Kern der Mission.

03 Missionsschritte

Haken Sie jeden Schritt ab. Hängen Sie fest? Unter jedem Schritt steht ein «Frag die KI»-Prompt – die KI ist Ihre Tutorin.

  1. Schritt 1 Funkgerät einschalten

    Öffnen Sie in LM Studio den Reiter Developer und schalten Sie den Server ein. LM Studio zeigt die Adresse an – meistens http://localhost:1234 (öffnet neues Fenster) (der Port ist in den Server-Einstellungen wählbar).

    Jetzt der erste Erfolg in 30 Sekunden: Tippen Sie in die Adresszeile Ihres Browsers

    http://localhost:1234/v1/models

    Sie sehen eine Liste im JSON-Format mit Ihren Modellen. Herzlichen Glückwunsch: Ihr Modell hat soeben eine Adresse bekommen. localhost heisst «dieses Gerät» – von anderen Geräten aus ist die Adresse nicht erreichbar (Programme auf Ihrem Laptop können sie aber nutzen).

    Klappt nicht? Die Seite lädt nicht? Läuft der Server wirklich (Schalter im Reiter Developer)? Zeigt LM Studio einen anderen Port an, ersetzen Sie 1234 durch diesen. Die Liste ist leer? Dann haben Sie noch kein Modell heruntergeladen (Mission «Erster Start»).

    Hängen Sie fest? Frag die KI
    Frag die KI
    Ich bin Lehrperson und habe in LM Studio den lokalen Server gestartet. Im Browser sehe ich unter http://localhost:1234/v1/models eine Liste in geschweiften Klammern. Erkläre mir einfach, was «localhost», «Port 1234» und «/v1/models» bedeuten und was JSON ist. Verwende einen Vergleich mit einer Adresse und einem Briefkasten.
    Sag mir zum Schluss, wie sicher du dir bist, und nenne Suchbegriffe oder offizielle Stellen, an denen ich es prüfen kann – erfinde keine Links. Schweizer Rechtschreibung (immer «ss», kein Eszett).

    Direkt öffnen in: ChatGPT Claude Perplexity · Gemini, Grok, Copilot: kopieren und einfügen

  2. Schritt 2 Der Funktest aus dem Terminal

    Laden Sie das passende Funktest-Skript herunter (Downloads unten). Es fragt zuerst die Modellliste ab und schickt dann eine Testfrage. Es ändert nichts an Ihrem Gerät und spricht nur mit localhost.

    • macOS/Linux: Terminal im Download-Ordner öffnen und bash funktest.sh eingeben.
    • Windows: PowerShell im Download-Ordner öffnen und powershell -ExecutionPolicy Bypass -File .\funktest.ps1 eingeben. Der Zusatz gilt nur für diesen einen Aufruf.

    Öffnen Sie das Skript vorher mit einem Texteditor und lesen Sie die Kommentare. Fremde Skripte nie ungelesen ausführen – das gilt auch für unsere.

    Prompt für die KI· z. B. in LM Studio

    Ausfüllen (optional), dann kopieren:

    Ich bin Lehrperson an einer Schweizer Berufsfachschule und lerne gerade, mit dem lokalen Server von LM Studio zu arbeiten.
    Erkläre mir dieses Skript Zeile für Zeile in einfachen Worten. Sag mir ausdrücklich, ob es etwas an meinem Gerät verändert, Daten ins Internet schickt oder sonst riskant ist.
    [SKRIPT, hier den Inhalt von funktest.sh oder funktest.ps1 einfügen]
    Schweizer Rechtschreibung (immer «ss», kein Eszett).

    Am einfachsten im Chat-Reiter von LM Studio – dann bleibt alles lokal. Das Skript enthält keine Personendaten; Sie können es auch in einen Cloud-Chat kopieren. So üben Sie den Reflex, Skripte vor dem Ausführen erklären zu lassen.

    Direkt öffnen in: ChatGPT Claude Perplexity · Gemini, Grok, Copilot: kopieren und einfügen Bitte zuerst die Felder oben ausfüllen.

    Klappt nicht? Windows meldet, dass Skripte deaktiviert sind? Verwenden Sie genau den Befehl mit «-ExecutionPolicy Bypass» – er gilt nur für diesen Aufruf. Ändern Sie keine dauerhaften Sicherheitseinstellungen. Geht es trotzdem nicht, öffnen Sie im Browser http://localhost:1234/v1/models (öffnet neues Fenster); das genügt für den Modell-Teil.

    Hängen Sie fest? Frag die KI
    Frag die KI

    Ausfüllen (optional), dann kopieren:

    Ich bin Lehrperson und habe noch nie ein Skript im Terminal bzw. in der PowerShell ausgeführt. Wie öffne ich auf [BETRIEBSSYSTEM, z. B. Windows 11] ein Terminal genau im Ordner, in dem meine heruntergeladene Datei liegt? Erkläre es Schritt für Schritt.
    Sag mir zum Schluss, wie sicher du dir bist, und nenne Suchbegriffe oder offizielle Stellen, an denen ich es prüfen kann – erfinde keine Links. Schweizer Rechtschreibung (immer «ss», kein Eszett).

    Direkt öffnen in: ChatGPT Claude Perplexity · Gemini, Grok, Copilot: kopieren und einfügen Bitte zuerst die Felder oben ausfüllen.

  3. Schritt 3 Anatomie eines Funkspruchs

    Eine Chat-Anfrage an den Server ist ein kleiner Brief mit drei Teilen: welches Modell, das Gespräch (Rollenanweisung und Ihre Frage) und wie kreativ es antworten soll.

    So sieht der Brief aus (JSON)

    Adresse: POST /v1/chat/completions

    {
      "model": "name-aus-der-liste",
      "messages": [
        { "role": "system", "content": "Du antwortest kurz auf Deutsch." },
        { "role": "user",   "content": "Melde dich wie ein Funker." }
      ],
      "temperature": 0.7
    }
    
    • model: welches Modell antworten soll (Namen aus /v1/models kopieren).
    • messages: das Gespräch. system ist die Rollenanweisung, user Ihre Frage, assistant frühere Antworten des Modells.
    • temperature: wie kreativ bzw. zufällig das Modell antwortet. Niedrig = sachlich, hoch = verspielt.

    Der Aufbau ist OpenAI-kompatibel: Viele Programme, die für ChatGPT-Schnittstellen gebaut wurden, können so auch mit Ihrem lokalen Modell sprechen. Einen API-Schlüssel braucht es lokal nicht, solange Sie in LM Studio keine Authentifizierung einschalten.

    Hängen Sie fest? Frag die KI
    Frag die KI
    Ich bin Lehrperson und lerne die Chat-Schnittstelle von LM Studio kennen (OpenAI-kompatibel, POST /v1/chat/completions). Erkläre mir den Unterschied zwischen den Rollen «system», «user» und «assistant» an einem Beispiel aus dem Unterricht, und was «temperature» bewirkt. Was steht in der Antwort unter «choices» und «usage»?
    Sag mir zum Schluss, wie sicher du dir bist, und nenne Suchbegriffe oder offizielle Stellen, an denen ich es prüfen kann – erfinde keine Links. Schweizer Rechtschreibung (immer «ss», kein Eszett).

    Direkt öffnen in: ChatGPT Claude Perplexity · Gemini, Grok, Copilot: kopieren und einfügen

  4. Schritt 4 Sabotage-Labor: Fehler mit Absicht

    Öffnen Sie die Diagnosekarte (Download): Sie enthält bereits sieben typische Fehlerbilder. Jetzt sabotieren Sie selbst. Lösen Sie mindestens drei der folgenden Pannen aus, starten Sie jedes Mal den Funktest und vergleichen Sie das Symptom mit der Karte:

    1. Server aus: Schalter in LM Studio aus, Funktest starten.
    2. Falscher Port: macOS/Linux BASIS=http://localhost:1235/v1 bash funktest.sh, Windows powershell -ExecutionPolicy Bypass -File .\funktest.ps1 -Basis http://localhost:1235/v1.
    3. Tippfehler im Pfad: im Browser http://localhost:1234/v1/model (ohne «s») aufrufen.
    4. Falscher Modellname: macOS/Linux MODELL=gibt-es-nicht bash funktest.sh, Windows powershell -ExecutionPolicy Bypass -File .\funktest.ps1 -Modell gibt-es-nicht.

    Entdecken Sie es? Pannen 1 und 2 sehen genau gleich aus. Das Symptom verrät die Ursache nicht immer – darum prüft man zuerst die einfachen Dinge.

    Tipp: Machen Sie daraus ein Partnerspiel: Eine Person sabotiert heimlich, die andere diagnostiziert nur anhand der Meldung. Wer am schnellsten die Ursache findet, gewinnt die Runde.

    Hängen Sie fest? Frag die KI
    Frag die KI

    Ausfüllen (optional), dann kopieren:

    Ich bin Lehrperson an einer Schweizer Berufsfachschule. Ich teste den lokalen Server von LM Studio und bekomme diese Fehlermeldung: [FEHLERMELDUNG, z. B. «Failed to connect to localhost port 1235: Connection refused»]. Was bedeutet sie in einfachen Worten, welche zwei oder drei Ursachen kommen in Frage, und in welcher Reihenfolge prüfe ich sie?
    Sag mir zum Schluss, wie sicher du dir bist, und nenne Suchbegriffe oder offizielle Stellen, an denen ich es prüfen kann – erfinde keine Links. Schweizer Rechtschreibung (immer «ss», kein Eszett).

    Direkt öffnen in: ChatGPT Claude Perplexity · Gemini, Grok, Copilot: kopieren und einfügen Bitte zuerst die Felder oben ausfüllen.

  5. Schritt 5 Das CORS-Rätsel und der Sicherheitsschalter

    Eine Panne können Sie im Terminal nie sehen: CORS. Webseiten dürfen im Browser nicht einfach mit einem anderen Server sprechen – der Server muss es erlauben. In LM Studio heisst der Schalter «Enable CORS». Ist er aus, klappt der Funktest im Terminal, aber Ihre eigene Webseite in der nächsten Mission meldet nur «Failed to fetch». Tragen Sie das jetzt schon auf der Diagnosekarte ein – Sie werden sich daran erinnern.

    Dazu kommt ein Schutz in Chrome (Local Network Access): Eine öffentliche Webseite darf nur über HTTPS und mit Ihrer ausdrücklichen Freigabe auf localhost zugreifen. Eigene KI-Webseiten öffnen Sie darum lokal. Fremden Webseiten geben Sie diese Freigabe nicht.

    Bordcheck: Der Server verlangt standardmässig kein Passwort. Schalten Sie CORS nur ein, solange Sie Ihre eigene Seite nutzen, und danach wieder aus. Der Schalter «Serve on Local Network» macht Ihr Modell für alle Geräte im WLAN erreichbar. Nur zusammen mit «Require Authentication» und nach Absprache mit der ICT-Abteilung. Und: Texte, die Sie dem Modell geben, können versteckte Anweisungen enthalten (Prompt-Injection) – auch lokale Modelle fallen darauf herein.

    Klappt nicht? Sie finden den CORS-Schalter nicht? Er steht in den Server-Einstellungen im Reiter Developer. Die Oberfläche ändert sich mit neuen Versionen; die offizielle Doku «Server Settings» nennt die aktuellen Namen.

    Hängen Sie fest? Frag die KI
    Frag die KI
    Ich bin Lehrperson. Erkläre mir mit einem Alltagsvergleich, was CORS im Browser ist und warum ein Skript im Terminal davon nicht betroffen ist, eine Webseite aber schon. Erkläre danach in drei Sätzen, was die Chrome-Funktion «Local Network Access» schützt.
    Sag mir zum Schluss, wie sicher du dir bist, und nenne Suchbegriffe oder offizielle Stellen, an denen ich es prüfen kann – erfinde keine Links. Schweizer Rechtschreibung (immer «ss», kein Eszett).

    Direkt öffnen in: ChatGPT Claude Perplexity · Gemini, Grok, Copilot: kopieren und einfügen

Twist · +50 XP

ORBITs gemeinste Sabotage

Stellen Sie die temperature im Funktest-Skript auf 0 und lassen Sie es dreimal laufen. Dann auf 1.5, wieder dreimal. Bei 0 antwortet das Modell meist fast gleich, bei 1.5 wird aus der Funkerin eine Dichterin – manchmal eine ziemlich wirre.

Wetten Sie vorher mit einer Kollegin: Ab welchem Wert wird es unbrauchbar? Wer näher dran ist, darf die nächste Sabotage aussuchen.

04 Qualitätscheck +25 XP

Erst wenn alles stimmt, ist Ihr Produkt bereit für den Unterricht. Die Verantwortung bleibt bei Ihnen – die KI liefert Entwürfe.

05 Transfer in den Alltag

Hängen Sie die Diagnosekarte neben Ihren Arbeitsplatz und geben Sie sie Kolleg/innen, die die Welt nach Ihnen spielen. In ICT-Klassen ist das Sabotage-Labor eine fertige Übung zur Fehlersuche: Lernende sabotieren sich gegenseitig und dokumentieren Symptom, Ursache und Massnahme.

Bezug zur Berufsbildung

Fehlerbilder systematisch eingrenzen (Symptom, Ursache, Massnahme) ist eine Kernkompetenz in ICT-Berufen und überall, wo Geräte gewartet werden – von der Elektroinstallation bis zur Medizintechnik. Die Diagnosekarte ist ein direkt übertragbares Format für Lernende.

06 Funkquiz fehlerfrei +25 XP

1 Was bedeutet die Adresse http://localhost:1234?
2 Der Funktest im Terminal klappt, Ihre Webseite meldet «Failed to fetch». Was prüfen Sie zuerst?
3 Server aus und falscher Port: Wie unterscheiden sich die Symptome?
4 Warum gehört «Serve on Local Network» nur mit «Require Authentication» eingeschaltet?

07 Weiterfragen: Mehr wissen mit der KI

Neugierig geworden? Diese Prompts holen Ihnen genau die Infos, die Sie interessieren. Tipp: Bitten Sie die KI immer auch um Belege – und prüfen Sie diese.

3 Prompts zum Weiterfragen anzeigen
Weiterfragen
Was bedeutet «OpenAI-kompatible Schnittstelle» bei lokalen Sprachmodellen, und welche Vorteile hat das für Lehrpersonen, die eigene kleine Werkzeuge bauen wollen? Nenne auch Grenzen dieser Kompatibilität.
Sag mir zum Schluss, wie sicher du dir bist, und nenne Suchbegriffe oder offizielle Stellen, an denen ich es prüfen kann – erfinde keine Links. Schweizer Rechtschreibung (immer «ss», kein Eszett).

Direkt öffnen in: ChatGPT Claude Perplexity · Gemini, Grok, Copilot: kopieren und einfügen

Weiterfragen
Ich bin Lehrperson an einer Schweizer Berufsfachschule. Was sind Token, und warum zeigt die Antwort eines Sprachmodells unter «usage» eine Token-Zahl? Erkläre es mit einem Beispiel auf Deutsch und sag, ob sich die Zählweise zwischen Modellen unterscheidet.
Sag mir zum Schluss, wie sicher du dir bist, und nenne Suchbegriffe oder offizielle Stellen, an denen ich es prüfen kann – erfinde keine Links. Schweizer Rechtschreibung (immer «ss», kein Eszett).

Direkt öffnen in: ChatGPT Claude Perplexity · Gemini, Grok, Copilot: kopieren und einfügen

Weiterfragen
Ich bin Lehrperson an einer Schweizer Berufsfachschule. Wie funktioniert Prompt-Injection bei Sprachmodellen, und warum sind auch lokale Modelle betroffen? Gib mir zwei harmlose Beispiele, die ich im Unterricht zeigen kann.
Sag mir zum Schluss, wie sicher du dir bist, und nenne Suchbegriffe oder offizielle Stellen, an denen ich es prüfen kann – erfinde keine Links. Schweizer Rechtschreibung (immer «ss», kein Eszett).

Direkt öffnen in: ChatGPT Claude Perplexity · Gemini, Grok, Copilot: kopieren und einfügen

08 Downloads

09 Logbuch-Eintrag

Zwei Minuten Reflexion verankern mehr als zwanzig Minuten Lesen. Notieren Sie Ihre Antworten im eigenen Logbuch (Papier, Notiz-App) – diese Seite speichert keine Texte.

  • Welche Sabotage hätte Sie im Ernstfall am längsten aufgehalten – und woran erkennen Sie sie jetzt?
  • Wie erklären Sie einer Kollegin in zwei Sätzen, was der lokale Server ist?
  • Welche Fehlersuch-Strategie aus dieser Mission können Ihre Lernenden auch in ihrem Beruf brauchen?

Quellen und Stand

Inhalt zuletzt geprüft am 19. November 2026. Werkzeuge ändern sich schnell – fällt Ihnen etwas auf? Melden Sie es uns.