-
Notifications
You must be signed in to change notification settings - Fork 261
Running Pow with Apache
If you want to run pow alongside the MacOS X built-in apache this page will instruct you on how to setup pow so that it doesn't takeover port 80 and instead apache will reverse proxy requests to pow.
$ curl get.pow.cx/uninstall.sh | sh #if you have pow installed
$ echo 'export POW_DST_PORT=88' >> ~/.powconfig; source ~/.powconfig
$ sudo curl -L https://gist.githubusercontent.com/soupmatt/1058580/raw/zzz_pow.conf -o /private/etc/apache2/other/zzz_pow.conf
$ sudo apachectl restart
$ curl get.pow.cx | sh
Before you install pow, add the following line to your ~/.powconfig
export POW_DST_PORT=88
Here it is as a one-liner
$ echo 'export POW_DST_PORT=88' >> ~/.powconfig; source ~/.powconfig
This will cause pow's firewall run to redirect all traffic from port 88 instead of port 80. You can pick any port you like for this if you use 88 for something else. It doesn't affect the remainder of these instructions. If you have already installed pow, you will need to uninstall it before you you continue.
If you need those instructions, you can find them here: Installation
You'll need to drop the file in this gist into
/etc/apache2/other/zzz_pow.conf
Here it is as a one-liner
$ sudo curl https://gist.githubusercontent.com/soupmatt/1058580/raw/zzz_pow.conf -o /etc/apache2/other/zzz_pow.conf
This sets up apache to act as a reverse proxy to pow. It goes directly at pow's default listen port, not the firewall port we configured in the previous step. The file name zzz_pow.conf to ensure that apache picks up the vhost for pow last, allowing you to put vhosts for other apps in front of it.
Use this config instead if you need Pow and Xcode CI on the same box: https://gist.github.com/qrush/84829fd3abe149559de0
You'll need to turn on "Websharing Sharing" in the MacOS X system preferences if you haven't already. You can find it in System Preferences -> Sharing -> Web Sharing. NOTE: This will make it so anyone with your machines IP Address can access your apache server. This is the default setting from apple. If you want to change this, you will want to change the IP address that apache binds to in /etc/apache2/httpd.conf.
If Apache is already running, you can restart by either turning Web Sharing off and then back on, or you use this on the command line
$ sudo apachectl restart
If you now configure your vhosts for the apps you want to run in apache with *.dev hostnames, pow will provide the DNS resolution for you, which means you get to keep the benefit of not mucking with your hosts file. For example, if you have a php app, you can setup its vhost entry to use my_php_app.dev and you don't need to add that to your hosts file.
This setup can be extended to allow using ssl with pow. To do this, you need to configure the pow vhost we setup for apache for ssl by following the apache documentation. The implementation is left as and exercise for the reader, and is restricted by the normal limitations of using ssl with apache and a name-based vhost configuration.
Make sure that you don't have another virtual host that is configured with the same name
Make sure that you have another (default) virtual host configured. For example, something like this:
/etc/apache2/other/aaa_default.conf
<VirtualHost *:80>
#no need for settings, use apache defaults.
</VirtualHost>
You also need to ensure VirtualHost's are enabled, that is this line needs to be in your config somewhere
NameVirtualHost *:80
You could put it into your httpd.conf or uncomment the vhosts extra line in it:
Include /private/etc/apache2/extra/httpd-vhosts.conf
I suggest you comment out the sample vhosts specified in that file.
Please make sure that in your httpd.conf you include your vhosts and other config files in the right order.
Include /private/etc/apache2/extra/httpd-vhosts.conf
Include /private/etc/apache2/other/*.conf
See: https://github.com/37signals/pow/issues/172#issuecomment-4610594