Diagnosekarte: lokaler Server

Für LM Studio, Stand 19.11.2026. Adresse im Normalfall: http://localhost:1234/v1 (Port in LM Studio einstellbar).

Erst die drei Grundfragen

  1. Läuft der Server? Reiter «Developer» in LM Studio, Schalter für den Server an. Test im Browser: http://localhost:1234/v1/models zeigt eine Liste.
  2. Stimmt die Adresse? Port und Pfad genau so, wie LM Studio sie anzeigt – mit /v1.
  3. Ist ein Modell vorhanden? In der Liste unter /v1/models muss ein Chat-Modell stehen.

Fehlerbilder

SymptomWahrscheinliche UrsacheWas tun?
Terminal: «Failed to connect … Connection refused». Browser: Seite nicht erreichbar. Server aus oder falscher Port. Beides sieht gleich aus! Server starten; Port in LM Studio ablesen und in der Adresse anpassen.
Antwort mit Fehlermeldung, dass es den Endpunkt nicht gibt. Tippfehler im Pfad, z. B. /v1/chat/completion statt /v1/chat/completions. Pfad buchstabengenau prüfen, inklusive /v1.
Fehlermeldung zum Modell, z. B. «nicht gefunden». Modellname falsch geschrieben oder Modell nicht heruntergeladen. Namen aus /v1/models kopieren, nicht abtippen.
Erste Antwort dauert sehr lange, danach geht es schneller. Das Modell wird beim ersten Aufruf geladen. Warten oder das Modell vorher in LM Studio laden.
Alles sehr langsam, Laptop wird zäh. Modell zu gross für den Speicher. Kleineres Modell, andere Programme schliessen (Geräte-Steckbrief).
Terminal klappt, Webseite nicht («Failed to fetch», in der Browser-Konsole ein Hinweis auf CORS). «Enable CORS» ist in den Server-Einstellungen aus. CORS einschalten. Das Terminal fragt nie nach CORS – nur Browser tun das.
Webseite aus dem Internet erreicht localhost nicht; Chrome fragt nach «Lokales Netzwerk». Schutz im Browser (Local Network Access): Öffentliche Seiten brauchen HTTPS und Ihre Freigabe, um auf Ihr Gerät zuzugreifen. Eigene KI-Webseite lokal öffnen (http://localhost:8000/…), nicht ins Internet stellen. Fremden Seiten keine Freigabe geben.
Bordcheck Sicherheit: Der Server verlangt standardmässig kein Passwort. «Enable CORS» darum nur einschalten, solange Sie Ihre eigene Seite nutzen, und danach wieder aus. «Serve on Local Network» macht das Modell für andere Geräte im WLAN erreichbar – nur zusammen mit «Require Authentication» und nur nach Absprache mit der ICT-Abteilung. Keine unbekannten MCP-Server einbinden. Und: Texte, die Sie dem Modell geben (Webseiten, Dokumente), können versteckte Anweisungen enthalten (Prompt-Injection). Lokale Modelle sind dagegen nicht immun.

Meine eigenen Fehlerbilder

SymptomUrsacheLösung

Vorlage aus dem KI-Universum (ki-universum.alpasana.ch, CC BY 4.0), Welt «Heimplanet Lokal». Quellen: lmstudio.ai/docs/developer/core/server/settings · lmstudio.ai/docs/developer/openai-compat · developer.chrome.com (Local Network Access). Genaue Fehlertexte können je nach Version abweichen.