Welcome to Voyager Help

Use the Search field below or select a Category from the list at the left

Configuring HQ and Agents to use a Reverse Proxy and Subdomains

HQ and Agents can be configured to use a reverse proxy and sub-domains. A reverse proxy appears as an ordinary web server to the client. In this model, the client makes ordinary requests for content in the namespace of the reverse proxy, which then decides where to send those requests and returns the content as if it were itself the origin.

There are three configuration steps that are needed:

  • Configuring hq.vmoptions
  • Setting the baseUrl
  • Configuring the Reverse Proxy

Configuring hq.vmoptions

Go to [HQ install dir] and edit hq.vmoptions to set -Dport to a custom port as appropriate, for example


Setting the baseUrl

In hq-home/config/config.yml, set the baseUrl as a root parameter with the desired public URL (proxy), for example:

baseUrl: http://hq.your_server.com

Configuring the Reverse Proxy

The following example uses Apache - see Notes for other solutions.

To configure Apache Reverse Proxy, use the ProxyPass and ProxyPassReverse directives to configure proxying a public URL, for example http://hq.your_server.com:80, to the proxy URL, for example
An example is shown below:

<VirtualHost *:80>
ServerName hq.your_server.com
ProxyRequests Off
ProxyVia Off
ProxyPass "/"
ProxyPassReverse "/"
ProxyPass /app
ProxyPassReverse /app
ProxyPass /api
ProxyPassReverse /api
ProxyPass /sock
ProxyPassReverse /sock


  • More information on Apache mod_proxy
  • Information on setting up a reverse proxy with IIS
  • Information on setting up a reverse proxy with nginx

See Also

Web Design and Web Development by Buildable