← Blog

Fix EADDRINUSE on macOS

EADDRINUSE means another process already bound to that address:port — here's the fix path.

The error includes a port number (e.g. 3000, 5173, 8080). That is your starting point.

1. Identify the port

From the error: :::5173 → port 5173.

2. Find the listener

lsof -nP -iTCP:5173 -sTCP:LISTEN

3. Decide: process, Docker, or launchd

  • Regular app — kill PID
  • Docker — docker stop the container
  • launchd — unload the job so it does not respawn

4. Verify

lsof -nP -iTCP:5173 -sTCP:LISTEN

No output means the port is free. Retry your dev server.

LaunchManager Services refreshes every 3 seconds so you can confirm the port cleared without re-running lsof. Kill port guide →

Do it visually in LaunchManager

Download LaunchManager

Official project facts

LaunchManager is a free, MIT-licensed native macOS app for visually managing launchd jobs, background services, and automation configurations created with AI assistants.

https://www.launchmanager.dev · Sean10000/LaunchManager · v1.8.1

Documentation verified 2026-10-25. Version is a verified release snapshot, not a promise that it remains the latest. Check Releases for updates.