HTTP redirects

Use the http-request redirect configuration directive to reroute HTTP traffic. These send back an HTTP redirect response to the client and then the client makes a new request to the new resource. When performing a redirection, the load balancer responds directly to the client. It doesn’t forward any traffic to the server.

Redirect traffic to a location Jump to heading #

Use http-request redirect location to replace the entire location of a URL. Below, we append a www subdomain in front of all URLs that don’t have it. To specify the HTTP status code to return, set the code parameter with any of the following values:

haproxy
frontend www
  bind :80
  acl has_www hdr_beg(host) -i www
  http-request redirect  code 301  location http://www.%[hdr(host)]%[capture.req.uri]  unless has_www
  default_backend webservers

haproxy
frontend www
  bind :80
  acl has_www hdr_beg(host) -i www
  http-request redirect  code 301  location http://www.%[hdr(host)]%[capture.req.uri]  unless has_www
  default_backend webservers

Redirect traffic using a prefix Jump to heading #

Use http-request redirect prefix to add a prefix to the URL’s location. Below, we prefix all URLs with /api/v2/ if they don’t have it. You don’t need to end the prefix with a slash. One will be added to the end of the prefix automatically.

haproxy
frontend www
  bind :80
  acl begins_with_api path_beg /api/v2/
  http-request redirect code 301 prefix /api/v2 unless begins_with_api
  default_backend webservers

haproxy
frontend www
  bind :80
  acl begins_with_api path_beg /api/v2/
  http-request redirect code 301 prefix /api/v2 unless begins_with_api
  default_backend webservers

Redirect the scheme Jump to heading #

Use http-request redirect scheme to redirect to a different scheme, such as from http:// to https://. In the following example, we redirect all HTTP traffic to HTTPS:

haproxy
frontend www
  bind :80
  bind :443 ssl crt /ssl.pem
  http-request redirect scheme https unless { ssl_fc }
  default_backend webservers

haproxy
frontend www
  bind :80
  bind :443 ssl crt /ssl.pem
  http-request redirect scheme https unless { ssl_fc }
  default_backend webservers

The Location header is built by concatenating the following elements in this order:

• the scheme (for example, https) provided by the directive
• ://
• the first occurrence of the Host header
• the URL

See also Jump to heading #

• For complete details about the redirect action, see the Redirect reference.