runnem kill

Kill any process running on a specific port.

Usage

runnem kill <port>

Description

The kill command forcefully terminates any process that is using a specified port. This is useful when:

• A port is in use but you don't know by what
• A service failed to clean up properly
• You need to free up a port quickly

Examples

# Kill process on port 3000
runnem kill 3000

# Kill process on port 8080
runnem kill 8080

How it works

1. Finds all processes using the specified port
2. Sends SIGKILL (kill -9) to each process
3. Verifies the port is free
4. Reports success or failure

Status Messages

# When a process is found and killed
🧹 Cleaned up processes using port 3000

# When no process is found
⚠️ No process found on port 3000

# When kill operation fails
❌ Failed to kill process on port 3000

Best Practices

1. Use as a last resort
2. Prefer runnem down for managed services
3. Check what's using the port first
4. Be cautious with system ports (<1024)

Next Steps

• Service Management - Learn how to manage your development services
• Configuration - See how to configure your services with a runnem YAML
• Why Runnem? - Learn the philosophy and motivation behind the tool