Skip to main content
Start the cordon proxy server. The proxy loads config, resolves secrets, and begins intercepting requests.

Usage

cordon start [OPTIONS]

Options

OptionDefaultDescription
--config, -ccordon.yamlPath to config file
--log-levelinfoLog level: trace, debug, info, warn, error

Examples

# Start with defaults
cordon start

# Start with a custom config file
cordon start --config /path/to/cordon.yaml

# Start with debug logging
cordon start --log-level debug

Behavior

  1. Parses and validates the config file. Exits with an error if invalid.
  2. Starts the health endpoint immediately (serves 503).
  3. Resolves all secrets from configured sources. Exits if any secret resolution fails.
  4. Generates or loads TLS certificates (if TLS is enabled).
  5. Binds the listener on the configured address.
  6. Marks the health endpoint as ready (200).
  7. Begins accepting connections.
The proxy runs in the foreground. Use Ctrl+C to stop, or run as a background service.