Zum Inhalt springen
SONOYA.com
Apple Mac

Port belegt am Mac: „Address already in use“ lösen

Dev-Server startet nicht, weil der Port belegt ist? So findest Du am Mac mit lsof den Prozess, beendest ihn sauber und gibst Port 5000 von AirPlay frei.

Von

Symbol eines eingesteckten Steckers auf dunklem Verlauf als Bild für einen belegten Netzwerk-Port am Mac

Du startest Deinen lokalen Server, und statt einer laufenden App kommt Error: listen EADDRINUSE: address already in use :::3000 oder OSError: [Errno 48] Address already in use. Gemeint ist immer dasselbe: Auf dem Port lauscht bereits ein anderes Programm, und ein Port kann nur von einem Prozess gleichzeitig belegt werden. Hier findest Du in einer Minute heraus, wer das ist, und beendest ihn sauber, statt den Mac neu zu starten.

Die Befehle habe ich unter macOS 27.2 im Terminal mit der vorinstallierten zsh nachvollzogen, sie funktionieren unter macOS Tahoe identisch.

Den Prozess hinter dem Port finden

macOS bringt dafür lsof mit, das „list open files“ bedeutet und auch Netzwerkverbindungen anzeigt. Ersetze 3000 durch den Port aus Deiner Fehlermeldung:

Code
lsof -nP -iTCP:3000 -sTCP:LISTEN

-iTCP:3000 filtert auf den Port, -sTCP:LISTEN zeigt nur Programme, die dort auf Verbindungen warten, und -nP verhindert, dass lsof Adressen und Ports in Namen übersetzt, was die Ausgabe schneller und eindeutiger macht. Ist der Port belegt, siehst Du eine Zeile wie diese:

Code
COMMAND   PID   USER   FD   TYPE             DEVICE SIZE/OFF NODE NAME
Python  65549 enrico    3u  IPv6 0xf4c561b94b5f7c8f      0t0  TCP *:8765 (LISTEN)

Wichtig sind die ersten beiden Spalten: COMMAND ist der Programmname, PID die Prozessnummer, mit der wir gleich arbeiten. Kommt gar keine Ausgabe, hat entweder kein Programm den Port, oder er gehört einem Prozess eines anderen Benutzers, etwa einem Systemdienst. Dann hilft derselbe Befehl mit vorangestelltem sudo, nach dem das Terminal Dein Mac-Passwort abfragt.

Häufig ist es schlicht ein alter Dev-Server, den Du in einem anderen Terminal-Tab oder in VS Code vergessen hast, oder einer, der nach einem Absturz im Hintergrund weiterläuft.

Den Prozess sauber beenden

Wenn Du den Tab mit dem alten Server noch findest, beende ihn dort mit ctrl + C. Das ist der sauberste Weg, weil das Programm noch aufräumen darf. Ist der Tab weg, beendest Du den Prozess über seine PID:

Code
kill 65549

Ersetze 65549 durch die PID aus der lsof-Ausgabe. kill ohne weitere Angabe sendet das Signal TERM, also die höfliche Bitte, sich zu beenden. Prüf danach mit dem lsof-Befehl von oben, ob der Port frei ist: Kommt keine Ausgabe mehr, kannst Du Deinen Server neu starten.

Hängt das Programm und reagiert nicht, erzwingst Du das Ende mit kill -9 65549. Nimm das erst als zweiten Versuch, denn dabei bekommt der Prozess keine Gelegenheit mehr, offene Dateien zu schreiben.

Für beides in einem Rutsch kannst Du die PID auch direkt übergeben:

Code
kill $(lsof -tiTCP:3000 -sTCP:LISTEN)

-t lässt lsof nur die nackte Prozessnummer ausgeben, die kill dann übernimmt. Schau Dir aber vorher einmal an, welches Programm dahintersteckt, damit Du nicht versehentlich etwas Wichtiges beendest.

Port 5000 und 7000: der AirPlay-Empfänger

Steht in der Spalte COMMAND der Eintrag ControlCe (abgeschnitten für ControlCenter), ist es kein vergessener Server, sondern macOS selbst. Der AirPlay-Empfänger, mit dem Dein Mac Bilder und Musik vom iPhone empfangen kann, belegt die Ports 5000 und 7000. Genau auf 5000 starten aber Flask und viele andere Entwicklungswerkzeuge standardmäßig.

Beenden bringt hier nichts, ControlCenter startet sofort neu. Schalte stattdessen die Funktion ab:

  1. Öffne die Systemeinstellungen.
  2. Klicke in der Seitenleiste auf Allgemein.
  3. Wähle AirDrop & Continuity (in älteren macOS-Versionen AirDrop & Handoff).
  4. Schalte AirPlay-Empfänger aus.

Der Port ist sofort frei, ein Neustart ist nicht nötig. Die Einstellung beschreibt Apple in seinem Mac-Benutzerhandbuch zu AirPlay. Wenn Du den Mac weiterhin als AirPlay-Ziel brauchst, lass die Funktion an und starte Deinen Server einfach auf einem anderen Port, bei Flask etwa mit flask run --port 5001.

Wenn Docker den Port hält

Beginnt der Eintrag in der Spalte COMMAND mit com.docke (abgeschnitten für com.docker.backend), gehört der Port einem Container, den Docker Desktop nach außen freigibt. Beende dann nicht den Docker-Prozess, sondern den Container. Welcher es ist, zeigt Dir:

Code
docker ps

In der Spalte PORTS siehst Du Einträge wie 0.0.0.0:3000->3000/tcp. Stoppe den passenden Container mit docker stop <name>, wobei Du <name> durch den Namen aus der letzten Spalte ersetzt. Läuft das Projekt mit Docker Compose, beendest Du es im Projektordner mit docker compose down. Wie Ports in Compose-Dateien gemappt werden und wie Du Konflikte schon dort vermeidest, erklärt Docker Compose verstehen: Volumes, Netzwerke und .env.

Wenn die Meldung trotzdem bleibt

Ist der Port laut lsof frei und die Fehlermeldung kommt trotzdem, startet Dein Projekt sehr wahrscheinlich zwei Server auf demselben Port, etwa weil ein Watcher-Skript den Server doppelt aufruft oder zwei Konfigurationen denselben Port eintragen. Such im Projekt nach der Portnummer, zum Beispiel mit grep -rn "3000" --include="*.json" ., und prüf die Startskripte in package.json.

Ein kleiner Helfer für den Alltag ist eine Shell-Funktion, die Dir den langen Befehl spart. Füge in Deiner ~/.zshrc diese Zeile hinzu:

Code
port() { lsof -nP -iTCP${1:+:$1} -sTCP:LISTEN }

Nach einem neuen Terminal-Fenster genügt dann port 3000, um den Besitzer zu sehen, und port allein listet alle Programme, die auf Deinem Mac auf Verbindungen warten. Der Ausdruck ${1:+:$1} hängt den Doppelpunkt und die Portnummer nur an, wenn Du eine angibst. Wie Funktionen, Aliase und die .zshrc funktionieren, zeigt zsh am Mac: PATH, Aliase und „command not found“, und wer seinen Mac gerade frisch für die Entwicklung aufsetzt, findet den Rest in Mac für Entwickler einrichten: der Leitfaden für 2026.

Weiterlesen.