CortexDocumentation

Fix Sensor port conflicts

Updated

For developers running local services on the same device as Cortex.

Cortex's local ports

Cortex uses these local ports:

PortCortex use
9000Local relay and Sensor status
9001Browser proxy
19090Browser routing configuration file

A development server or another Cortex process on one of these ports can prevent Cortex from starting.

Fix a port conflict

If Cortex could not start and Port owners appears:

  1. Open Sensor. Under the startup error, expand Port owners and note the port and process.
  2. If the process is a development service you own, stop it or configure it to use another port.
  3. If the process is another Cortex instance, quit that instance from the Cortex menu. On macOS, you can also stop the known Cortex process in Activity Monitor.
  4. Select Start Cortex, then Run checks.

Port owners details under a Sensor startup error

The conflict is fixed when the status at the top of Sensor shows Running and the startup error no longer appears.

If you do not recognize the process, include the port-owner details when you contact the Chaos Labs team.

After Cortex starts, use Verify Sensor setup to confirm that a new prompt is captured and synced.

Was this helpful?