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.
Services are optional. Most development workflows don’t need a background service — just run cordon start alongside your app (e.g., in a Procfile). Use cordon service install when you want the proxy to start automatically on login and restart on failure for a specific project. Each service is tied to one project’s cordon.toml.
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.