Skip to main content
Install cordon as an OS-managed background service that starts automatically and restarts on failure.

cordon service install

cordon service install [OPTIONS]
OptionDefaultDescription
--namedefaultService instance name (for running multiple instances)
--configcordon.tomlPath to an existing config file (relative to the directory you run the command from, unless you pass an absolute path)
This command does not create or edit cordon.toml — it only installs OS service metadata so the service runs cordon start with the config path you pass. The file must already exist, usually from cordon setup.
When do you need this command?
  • Project development: run setup first, then install a service for that project if you want cordon to start automatically: cordon service install --name my-project --config ./cordon.toml.
  • Custom config locations: pass --config explicitly if the file is not ./cordon.toml in your current directory.
See setup for the full layout.
Installs a launchd user agent at ~/Library/LaunchAgents/.
cordon service install --config /path/to/cordon.toml

cordon service uninstall

cordon service uninstall [OPTIONS]
OptionDefaultDescription
--namedefaultService instance name

Multiple instances

Run separate cordon instances with different configurations:
cordon service install --name api-proxy --config ~/configs/api-cordon.toml
cordon service install --name db-proxy --config ~/configs/db-cordon.toml
Each instance gets its own service with an independent lifecycle.