diff --git a/doc/manual/installation.xml b/doc/manual/installation.xml index cebeb082..cb94dbbe 100644 --- a/doc/manual/installation.xml +++ b/doc/manual/installation.xml @@ -143,7 +143,7 @@ dbserver.example.org:*:hydra:hydra:password Make sure that the HYDRA_DATA directory exists and is writable for the user which will run the Hydra - services. + services. @@ -220,6 +220,58 @@ hydra-server +
+ Serving behind reverse proxy + + + To serve hydra web server behind reverse proxy like + nginx or httpd some + additional configuration must be made. + + + + Edit your hydra.conf file in a similar way to + this example: + + +using_frontend_proxy 1 +base_uri example.com + + base_uri should be your hydra servers proxied URL. + + If you are using Hydra nixos module then setting hydraURL + option should be enough. + + + + + + If you want to serve Hydra with a prefix path, for example + http://example.com/hydra then you need to configure your + reverse proxy to pass X-Request-Base to hydra, with + prefix path as value. + + For example if you are using nginx, then use configuration similar to following: + +server { + listen 433 ssl; + server_name example.com; + .. other configuration .. + location /hydra/ { + + proxy_pass http://127.0.0.1:3000; + proxy_redirect http://127.0.0.1:3000 https://example.com/hydra; + + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + proxy_set_header X-Request-Base /hydra; + } +} + + +