Caddy(8) Caddy(8)

# [NAME](#NAME)

caddy-stop - Gracefully stops a started Caddy process

# [SYNOPSIS](#SYNOPSIS)

**caddy stop \[--config \[--adapter ]] \[--address ] \[flags]**

# [DESCRIPTION](#DESCRIPTION)

Stops the background Caddy process as gracefully as possible.

It requires that the admin API is enabled and accessible, since it will use the API's /stop endpoint. The address of this request can be customized using the --address flag, or from the given --config, if not the default.

# [OPTIONS](#OPTIONS)

**-a**, **--adapter**="" Name of config adapter to apply (when --config is used)

**--address**="" The address to use to reach the admin API endpoint, if not the default

**-c**, **--config**="" Configuration file to use to parse the admin address, if --address is not used

**-h**, **--help**\[=false] help for stop

# [SEE ALSO](#SEE_ALSO)

[**caddy(8)**](/man/enterprise-packages/caddy/caddy.8)

# [HISTORY](#HISTORY)

7-Oct-2026 Auto generated by spf13/cobra

Oct 2026 Auto generated by spf13/cobra

---

Document: caddy-stop(8) from caddy 2.11.7-r1 (Chainguard OS)
Source: https://github.com/caddyserver/caddy