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 Nathan Base
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:
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:
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:
kill 65549Ersetze 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:
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:
- Öffne die Systemeinstellungen.
- Klicke in der Seitenleiste auf Allgemein.
- Wähle AirDrop & Continuity (in älteren macOS-Versionen AirDrop & Handoff).
- 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:
docker psIn 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:
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.
-
Apple MacMac für Entwickler einrichten: der Leitfaden für 2026
Neuen Mac fürs Programmieren einrichten: Homebrew, Git, SSH, GitHub, VS Code, Python, Docker, Claude Code und ein Brewfile für den nächsten Mac.
Nathan Base -
Apple Maczsh am Mac: PATH, Aliase und „command not found“
„zsh: command not found“ am Mac? So funktioniert der PATH, welche Startdatei wann lädt und wie Du ihn dauerhaft erweiterst und Aliase anlegst.
Nathan Base -
Selfhosting & WebDocker Compose verstehen: Volumes, Netzwerke und .env
Docker Compose verständlich erklärt: Named Volume oder Bind Mount, Dienstnamen als Hostnamen, .env-Variablen, Healthchecks, sichere Updates und Backups.
Nathan Base -
Apple MacHomebrew auf dem Mac installieren: Anleitung für macOS 27
Homebrew auf dem Mac installieren, den Pfad in der zsh einrichten und die wichtigsten brew-Befehle nutzen. Für Apple-Chip und Intel, mit Fehlerhilfe.
Nathan Base -
Apple MacMac startet ständig neu: Kernel-Panic-Bericht lesen
Mac startet wegen eines Problems neu? So findest und liest Du den Kernel-Panic-Bericht und erkennst, ob Software, Zubehör oder Hardware schuld ist.
Nathan Base -
Apple MacAktivitätsanzeige am Mac: kernel_task und Co. erklärt
kernel_task, WindowServer oder mds_stores frisst CPU? So liest Du die Aktivitätsanzeige am Mac und erkennst, welcher Prozess harmlos ist.
Nathan Base