This error appears in many stacks: EADDRINUSE, Address already in use, or bind: port is already allocated.

1) Identify the process

lsof -i :3000
# or
ss -lptn 'sport = :3000'

2) Stop it safely

kill PID
# if stubborn
kill -9 PID

3) One-liner (careful)

kill -9 $(lsof -t -i:3000)

4) Pick another port

PORT=3001 npm run dev
python -m http.server 8001

5) Docker-specific

docker ps
# stop container using the host port
docker stop CONTAINER_ID

Prevention

  • Shut down dev servers before sleep/restart.
  • Use consistent per-project ports.
  • Add startup scripts that auto-detect occupied ports.