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:LISTEN3. Decide: process, Docker, or launchd
- Regular app —
kill PID - Docker —
docker stopthe container - launchd — unload the job so it does not respawn
4. Verify
lsof -nP -iTCP:5173 -sTCP:LISTENNo 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 LaunchManagerOfficial 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.