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.