Ollama meldet einen belegten Port: Wie löse ich das?

Das Problem

Sie geben im Terminal ollama serve ein, und statt zu starten, meldet Ollama einen Fehler. Er lautet in etwa: «listen tcp 127.0.0.1:11434: bind: address already in use». Auf Deutsch: Die Adresse wird bereits verwendet.

Das klingt bedrohlich, ist aber meistens harmlos. Ein Computer hat für Programme, die über das Netzwerk (auch nur über den eigenen Rechner) erreichbar sind, nummerierte Eingänge, sogenannte Ports. Ollama nutzt standardmässig den Port mit der Nummer 11434. Ein Port kann aber nur von einem Programm gleichzeitig verwendet werden. Meldet Ollama, er sei belegt, hat bereits jemand die Tür besetzt.

Wer ist das? Meist Ollama selbst: Nach der Installation startet es oft automatisch als Dienst im Hintergrund. Wenn Sie es von Hand ein zweites Mal starten, stösst es auf sich selbst. Selten ist es ein anderes Programm. Diese Anleitung zeigt, wie Sie es herausfinden und lösen.

So lösen Sie es mit KI – Schritt für Schritt

1. Ruhe bewahren und die Meldung lesen. Merken Sie sich die Zahl hinter dem Doppelpunkt, meist 11434. Das ist der betroffene Port.

1. Prüfen, ob Ollama bereits läuft. Versuchen Sie, ohne ollama serve zu arbeiten: ollama list zeigt Ihre Modelle, wenn der Dienst läuft. Unter Linux zeigt systemctl status ollama, ob der Dienst aktiv ist. Unter Windows und macOS ist Ollama häufig als Anwendung in der Taskleiste oder Menüleiste aktiv.

1. Wenn es läuft: nichts weiter tun. In diesem Fall brauchen Sie ollama serve gar nicht. Es genügt, ollama run [modellname] zu starten. Die Fehlermeldung war ein Zeichen, dass alles in Ordnung ist.

1. Wenn Sie den Dienst neu starten wollen: Unter Linux sudo systemctl restart ollama. Unter Windows und macOS beenden Sie die Anwendung über die Taskleiste oder Menüleiste und starten sie neu.

1. Wer belegt den Port, wenn Ollama nicht läuft? Unter Linux zeigt sudo ss -ltnp | grep 11434 das Programm. Unter Windows hilft netstat -ano | findstr 11434 in der Eingabeaufforderung; die letzte Zahl ist die Prozessnummer, die der Task-Manager einem Programm zuordnet. Prüfen Sie, welches Programm es ist.

1. Entscheiden. Ist es ein zweiter Ollama-Prozess, beenden Sie ihn. Ist es ein anderes Programm, das Sie nicht brauchen, schliessen Sie es. Beenden Sie keine Programme, die Sie nicht kennen, ohne vorher nachzufragen, besonders nicht auf Firmenrechnern.

1. Alternativ eine andere Adresse wählen. Ollama liest die Umgebungsvariable OLLAMA_HOST, zum Beispiel 127.0.0.1:11435. Starten Sie damit, und nutzen Sie dieselbe Variable auch für den Chat-Befehl, damit er die neue Adresse findet. Dauerhaft tragen Sie sie wie beim Speicherort in die Dienstkonfiguration ein.

1. Testen und festhalten. ollama list und ein kurzer Chat zeigen, dass alles läuft. Notieren Sie, was die Ursache war.

Vorlage zum Kopieren

Mit diesem Auftrag lassen Sie sich helfen, die Ausgabe der Befehle zu deuten. Entfernen Sie vorher Benutzernamen und Pfade, die Sie nicht preisgeben möchten.

Ich bekomme bei Ollama die Fehlermeldung «address already in use». Hilf mir, die Ursache einzugrenzen.

Betriebssystem: [Linux / Windows / macOS]
Wie ich Ollama installiert habe: [als Dienst / App / Docker]
Fehlermeldung (wörtlich): [Text]
Ausgabe von «ollama list»: [Text oder «Fehler: ...»]
Ausgabe des Befehls zur Portprüfung (ss oder netstat), bereinigt: [Text]

Aufgabe:
1. Erkläre in einfachen Worten, was die Meldung bedeutet.
2. Sage, welche Ursache am wahrscheinlichsten ist, und begründe sie anhand der Ausgaben.
3. Schlage drei Prüfschritte vor, vom harmlosesten zum eingreifendsten.
4. Sage mir, welche Befehle ich NICHT ausführen soll, wenn ich unsicher bin (z. B. Programme beenden, die ich nicht kenne).
Erfinde keine Befehle. Wenn du etwas nicht sicher weisst, schreibe «in der Dokumentation prüfen».

Prüfen Sie jeden Vorschlag der KI, bevor Sie ihn ausführen, und beenden Sie nur Programme, die Sie eindeutig zuordnen können.

Worauf Sie achten müssen

• Keine fremden Programme beenden: Auf Firmenrechnern können Sicherheits- oder Verwaltungsprogramme Ports nutzen. Fragen Sie Ihre IT, bevor Sie etwas beenden.
• Nicht ins Netz öffnen: Wenn Sie OLLAMA_HOST ändern, achten Sie darauf, die Adresse nicht für das ganze Netzwerk freizugeben, etwa mit 0.0.0.0. Die Schnittstelle hat keine eigene Anmeldung. Siehe Ollama im Firmennetz.
• Docker und Container: Läuft Ollama in einem Container, kann der Port auf dem Rechner doppelt belegt sein, etwa durch eine Installation und einen Container gleichzeitig. Siehe Ollama mit Docker betreiben.
• Andere Fehlerbilder: Meldet der Chat «Verbindung abgelehnt», ist es ein anderes Problem. Siehe Ollama: Verbindung abgelehnt.
• Änderungen dokumentieren: Wer die Adresse ändert, muss alle Programme anpassen, die auf Ollama zugreifen, etwa Oberflächen oder Skripte.

Ein Beispiel aus der Praxis

Ein Beispiel: Ein Immobilientreuhänder in Baden installiert Ollama auf seinem Linux-Laptop. Beim Test tippt er ollama serve und erhält die Fehlermeldung. Er hält Ollama für defekt und möchte neu installieren.

Vorher will er alles löschen. Nachher prüft er mit ollama list, ob der Dienst reagiert, und sieht seine Modelle. Er versteht: Ollama läuft bereits im Hintergrund seit dem Hochfahren. Den Befehl ollama serve braucht er nicht. Er startet direkt ollama run [modellname] und chattet. Später möchte er ein Open-Source-Programm auf demselben Port testen, das ebenfalls 11434 nutzt. Er stellt dafür bei diesem Programm eine andere Portnummer ein. Beide laufen nun nebeneinander.

So hilft Ihnen Alpasana

Lokale KI mit Ollama und Open-Source-Modellen gehört zur Kursauswahl KI und IT für konkrete Arbeitsaufgaben von absofort, zusammen mit No-Code-Automatisierung, KI-Agenten und betrieblichen KI-Richtlinien, jeweils mit KI-Lerncoach, Praxisaufgaben und verifizierbarem Abschluss.

Die Fehlersuche an Ihrem konkreten Rechner übernimmt der Kurs nicht. Dafür ziehen Sie Ihre IT oder die Dokumentation von Ollama bei.

Häufige Fragen

Was ist ein Port?

Ein nummerierter Eingang eines Computers für Programme, die über das Netzwerk erreichbar sind. Jeder Eingang kann nur von einem Programm genutzt werden. Ollama verwendet standardmässig 11434.

Kann ich die Nummer einfach ändern?

Ja, mit der Umgebungsvariable OLLAMA_HOST. Alle Programme, die Ollama nutzen, müssen dann die neue Adresse kennen. Ändern Sie sie nur, wenn es einen Grund gibt.

Ist die Fehlermeldung gefährlich?

Nein, sie schadet nichts. Sie zeigt nur, dass der Start nicht möglich war, weil die Adresse besetzt ist. Das Problem lässt sich lösen, indem Sie die Ursache klären.