Skip to content

pitchfork stop

  • Usage: pitchfork stop [FLAGS] [ID]…
  • Aliases: kill
  • Effect: modifies state

Sends a stop signal to a daemon

Uses a graceful shutdown strategy:

  1. Send the configured stop signal (SIGTERM by default) to the process group and wait for stop_signal.timeout or supervisor.stop_timeout (default: 5s)
  2. If still running, send SIGKILL to force termination

Most processes exit promptly after the first signal. The escalation ensures stubborn processes are eventually terminated while giving well-behaved processes time to clean up resources.

When using --all/--local/--global, daemons are stopped in reverse dependency order: dependents are stopped before the daemons they depend on.

Examples:

pitchfork stop api           Stop a single daemon
pitchfork stop api worker    Stop multiple daemons
pitchfork stop --group backend Stop all daemons in the 'backend' group
pitchfork stop --all         Stop all running daemons in dependency order
pitchfork stop -l            Stop all local daemons in pitchfork.toml
pitchfork stop -g            Stop all global daemons in config.toml
pitchfork kill api           Same as 'stop' (alias)

Arguments

  • [ID]… — The name of the daemon(s) to stop

Flags

  • --group <GROUP> — Stop all daemons in the named group

  • -a --all — Stop all running daemons (in reverse dependency order)

  • -l --local — Stop all local daemons in pitchfork.toml

    Aliases: --all-local

  • -g --global — Stop all global daemons in ~/.config/pitchfork/config.toml and /etc/pitchfork/config.toml

    Aliases: --all-global

  • -h --help — Print help

MIT LicenseCopyright © 2026jdx.dev