This page is about Caddy 2. If you still need v1 docs for a limited time, click here.
Documentation

handle_path

Same as the handle directive, but implicitly strips the matched path prefix.

Handling a request matching a certain path (while stripping that path from the request URI) is a common enough use case that it has its own directive for convenience.

Syntax

handle_path <path_matcher> {
	<directives...>
}
  • <directives...> is a list of HTTP handler directives or directive blocks, one per line, just like would be used outside of a handle_path block.

Note that only a single path matcher is accepted and required; you cannot use other kinds of matchers with handle_path.

Examples

This configuration:

handle_path /prefix/* {
	...
}

is effectively the same as this:

handle /prefix/* {
	uri strip_prefix /prefix
	...
}

but the handle_path form is slightly more succinct.