Skip to main content
Stop a running cordon proxy. Finds the process listening on the configured port and sends SIGTERM.

​
Usage

cordon stop [OPTIONS]

​
Options

OptionDescription
--config, -cPath to config file (mutually exclusive with --scope)
--scopeproject (default) or user — selects which config file to read
--config and --scope are mutually exclusive — passing both is an error. Omitting both defaults to project scope ($CWD/cordon.toml).

​
Examples

# Stop the project-scope proxy
cordon stop

# Stop the user-scope proxy
cordon stop --scope user

# Stop a proxy using a specific config file
cordon stop --config /path/to/cordon.toml

​
Behavior

  1. Reads the config file to determine the listen port.
  2. Checks if a process is listening on that port. If not, prints a warning and exits.
  3. Checks if the port is managed by an installed service. If so, refuses to stop and suggests using cordon service stop instead.
  4. Verifies the process on the port is actually cordon before sending SIGTERM.
If cordon is running as an installed service, use cordon service stop instead — cordon stop will detect the service and point you there.