Advanced

Port Conflict Resolution

Port Conflict Resolution

DevDock automatically handles port conflicts so you don't have to manually hunt down what's using a port.

How It Works

  1. Detection: Before starting a service, DevDock checks if the configured port is already in use
  2. Notification: If a conflict is found, DevDock notifies you with details about which process is using the port
  3. Auto-reassignment: DevDock automatically finds the next available port and assigns it to the service
  4. Update: The service configuration is temporarily updated with the new port

Example Scenario

Configured: Frontend on port 3000
Detected:   Port 3000 is in use by process "node" (PID 12345)
Action:     Reassigned Frontend to port 3001

Manual Resolution

If you prefer to handle conflicts manually:

  1. Stop the conflicting process
  2. Change the port in the service configuration
  3. Restart the service in DevDock