If you've worked with Node.js, you've probably encountered this at some point:
Error: listen EADDRINUSE: address already in use :::3000 You try to start your development server, and suddenly port 3000 is already occupied.
Now begins the usual routine:
lsof -i :3000 Find the PID.
kill -9 <PID> Then try starting your server again.
It's not exactly difficult, but having to repeat these steps gets annoying, especially when you're switching between projects or running multiple development servers.
So I built Purgeport.
What is Purgeport?
Purgeport is a cross-platform CLI that helps you find and terminate processes occupying specific ports.
Instead of manually looking up PIDs and killing processes, you can simply run:
npx purgeport 3000 It identifies the process using the port, displays relevant process information, and lets you decide whether to terminate it.
Features
- Find processes occupying specified ports.
- Display process information before termination.
- Interactive confirmation before killing processes.
- Support for multiple ports.
- Cross-platform support.
- Simple CLI interface.
Installation
Install it globally using npm:
npm install -g purgeport Or run it directly with npx:
npx purgeport 3000 You can also pass multiple ports:
purgeport 3000 5173 8080 Why build another CLI for this?
There are already tools that solve this problem.
I wasn't trying to reinvent process management. I just wanted a small utility that makes this particular workflow less tedious, without remembering different commands or manually searching for process IDs.
Sometimes a small developer utility is all you need.
Try it out
- npm: - npm: https://www.npmjs.com/package/purgeport
- GitHub: https://github.com/rishhbh/purgeport
Purgeport has already crossed 1,000+ npm downloads, which is pretty exciting for a small utility I built.
If you try it, feedback, bug reports, and contributions are welcome.
And hopefully, the next time you encounter EADDRINUSE, you won't have to go hunting for PIDs manually.

