Introduction
You may want to run your QuickBuild instance behind Apache for some reasons. To do so, the following situations are assumed:
- The following commands are Ubuntu specified, if you are running on other platform, please reference the apache documents on your platform.
- An existing Apache web server has been set up already.
- mod_proxy
has been enabled. If you haven't, you may enable it by running command:
a2enmod proxy_http - You run your QuickBuild instance at http://localhost:8810, and you want site http://build.example.com on the regular port (80) available after configuring the mod_proxy.
Configure your apache
Create a file named build.example.com.conf at your apache configurations directory: your_apache_home/conf/sites-available and edit it by adding below lines:
<VirtualHost *:80>
# if you are configuring reverse proxy with https enabled, make sure to prepend the ServerName
# directive with "https://" schema, for example: https://build.example.com:443
ServerName build.example.com
ProxyRequests Off
# turn off this option. We will rely on ProxyPassReverse to translate
# urls in Http response headers.
ProxyPreserveHost Off
<Proxy *>
Order deny,allow
Allow from all
</Proxy>
ProxyPass / http://localhost:8810/
ProxyPassReverse / http://localhost:8810/
<Location />
Order allow,deny
Allow from all
</Location>
ErrorLog /var/log/apache2/quickbuild-error.log
CustomLog /var/log/apache2/quickbuild-access.log combined
LogLevel warn
</VirtualHost>
Then, we can enable this configuration and restart the apache server:
# a2ensite build.example.com.conf # /etc/init.d/apache2 reload
That is it.