---
name: "caddy-stop"
section: "8"
platform: "linux"
package: "caddy"
version: "2.6.2-12+deb13u1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/caddy-stop"
---

# caddy-stop(8)

Gracefully stops a started Caddy process

## NAME

caddy-stop - Gracefully stops a started Caddy process

## SYNOPSIS

**caddy stop \[flags\]**

## 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

**--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

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

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

## SEE ALSO

**[caddy(8)](/caddy/8.md)**

## HISTORY

10-Aug-2026 Auto generated by spf13/cobra