Skip to content

pitchfork restart

  • Usage: pitchfork restart [FLAGS] [ID]…

Restarts a daemon (stops then starts it)

Equivalent to start --force - stops the daemon with its configured signal, then starts it again from the pitchfork.toml configuration with dependency resolution.

Examples:

pitchfork restart api           Restart a single daemon
pitchfork restart api worker    Restart multiple daemons
pitchfork restart --group backend Restart all daemons in the 'backend' group
pitchfork restart --all         Restart all running daemons
pitchfork restart -l            Restart all local daemons in pitchfork.toml
pitchfork restart -g            Restart all global daemons in config.toml
pitchfork restart api --delay 5 Wait 5 seconds for daemon to be ready

Arguments

  • [ID]… — ID of the daemon(s) to restart

Flags

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

  • -a --all — Restart all running daemons

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

    Aliases: --all-local

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

    Aliases: --all-global

  • --delay <DELAY> — Delay in seconds before considering daemon ready (default: 3 seconds)

  • --output <OUTPUT> — Wait until output matches this regex pattern before considering daemon ready

  • --http <HTTP> — Wait until HTTP endpoint returns 2xx status before considering daemon ready

  • --port <PORT> — Wait until TCP port is listening before considering daemon ready

  • --cmd <CMD> — Shell command to poll for readiness (exit code 0 = ready)

  • --health-cmd <HEALTH_CMD> — Shell command to poll for health (exit code 0 = healthy)

  • --health-http <HEALTH_HTTP> — HTTP endpoint URL to poll for health

  • --health-port <HEALTH_PORT> — TCP port to probe for health (connection success = healthy)

  • -q --quiet — Suppress startup log output

  • -h --help — Print help

MIT LicenseCopyright © 2026jdx.dev