← Blog

How to kill a process using port 3000 on macOS

Port 3000 is the default for React, Next.js, and many API servers — here's how to unblock it.

You run npm run dev and see Error: listen EADDRINUSE: address already in use :::3000. Something is already listening on localhost:3000.

Step 1: Find the process

lsof -nP -iTCP:3000 -sTCP:LISTEN

Note the PID and COMMAND columns. Common culprits: a previous node process, another framework dev server, or Docker Desktop forwarding port 3000.

Step 2: Stop it safely

kill <PID>

If the command is com.docker or vpnkit, use docker ps to find the container and docker stop <name> instead.

Step 3: Prevent repeats

If a launchd job respawns the process, unload the LaunchAgent in LaunchManager instead of killing the child each time.

Do it visually

Open LaunchManager → Services, filter mentally for port 3000, see PID and Docker labels, then stop the right target. Port manager 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.