OS Manuals

/usr/bin/xcaddy

Build Caddy with plugins

From xcaddy 0.4.7-r6 (os), captured 2026-11-05 by running xcaddy --help (exit 0). permalink

xcaddy is a custom Caddy builder for advanced users and plugin developers.
The xcaddy command has two primary uses:
- Compile custom caddy binaries
- A replacement for `go run` while developing Caddy plugins
xcaddy accepts any Caddy command (except help and version) to pass through to the custom-built Caddy, notably `run` and `list-modules`.  The command pass-through allows for iterative development process.

When passing flags through to Caddy (for example `--config`), put them after `--` so xcaddy does not parse them:
  xcaddy -- run --config caddy.json

Report bugs on https://github.com/caddyserver/xcaddy

Usage:
  xcaddy <args...> [flags]
  xcaddy [command]

Available Commands:
  build       Compile custom caddy binaries
  completion  Generate the autocompletion script for the specified shell
  help        Help about any command
  version     Prints xcaddy version

Flags:
  -h, --help      help for xcaddy
  -v, --version   version for xcaddy

Use "xcaddy [command] --help" for more information about a command.

Full documentation is available at:
https://github.com/caddyserver/xcaddy
Options (2)
OptionDescriptionSource
-h, --helphelp for xcaddyhelp
-v, --versionversion for xcaddyhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.