Suburbia

Configuring Apache 2 with Virtual Hosts on Mac OSX Leopard

I recently installed Leopard on my development machine by doing a completely fresh install in order to have a clean system. One thing I found that I couldn't get running correctly was recreating my preferred Apache web server setup including Virtual Host configuration. Leopard runs Apache 2 by default but I had been running this on Tiger anyway rather than the default Apache 1.3.

Problem #1: Access denied using custom DocumentRoot

My first problem was that I like to use a different location for the DocumentRoot configuration, I keep my site files in 'Users/rickcurran/Documents/Client_Data' located in my Documents folder in my user account rather than in the default 'Library/Webserver/Documents' location. The problem I encountered was that if I changed the DocumentRoot to point to my preferred location I got a 'Forbidden - You don't have permission to access / on this server' message. I tried to get it working and just gave up for a while and used the standalone MAMP application in the mean time to get working because this had no problem pointing to my custom DocumentRoot location.

Solution to #1: Change the user that Apache webserver runs as

I eventually figured out that in Leopard Apache's default user (www) doesn't have permissions to access my Documents folder. I simply went and changed the User and Group settings in the httpd.conf file to use my user and group and then it worked fine. I'm sure you could probably add the default Apache user to a group or some other Users / Groups / Permissions setting but for a development machine this solution works fine!

Problem #2: An alternative to name-based virtual hosts avoiding netinfo / hosts files

I like to have all my sites both current and past projects running locally so that I can fix any bugs etc without having to work on live sites. Apache's Virtual Host configuration is perfect for the job. At first under leopard I just couldn't get them to work but I realised that I'd simply missed something out in the configuration, so it was more a human error really. However whilst Googling trying to figure out what I'd done wrong it reminded me that most tutorials on configuring Virtual Hosts under Apache do so by using name-based hosts which require you to edit the '/etc/hosts' file (or via Netinfo Manager on Tiger).

The drawback to this technique is that the sites are only viewable on your development machine, if other users on your network want to view the development sites they need to configure their own hosts file. This is a problem when you've got several machines that need to access the sites.

Solution to #2: Port based virtual hosts 

To get around the hassle of Netinfo / hosts configuration I use an alternative virtual hosts setting which uses a different port for each site and can be accessed on any machine on the network.

To set up port based virtual hosts you need to first uncomment a line in the main httpd.conf to enable virtual hosts in the first place. Next edit the 'httpd-vhosts.conf' file found in '/etc/apache2/extra/httpd-vhosts.conf', comment out the example virtual hosts that are there by default and then add your virtual hosts in the following way:

<VirtualHost *:80
    DocumentRoot "/Users/rickcurran/Documents/Client_Data/intranet"
</VirtualHost>

Listen 8081
<VirtualHost *:8081>
    DocumentRoot "/Users/rickcurran/Documents/Client_Data/myexamplesite_co_uk"
    ServerName 192.168.0.2:8081
</VirtualHost>

The first sets a default virtual host on port 80, the second sets up a site on port 8081. The examples above are very basic configurations, you could add support for error logs etc but this gets them up and running.

Restart Apache by unchecking and rechecking the Web Sharing tickbox in the Sharing System Preference you should then be able to access the 'myexamplesite_co_uk' site by using the URL 'http://localhost:8081'. Also anybody else on the network can access the site too without messing around with the 'etc/hosts' file!

Scared to edit httpd.conf etc? Try HeadDress

If you don't like editing config files via the Terminal then there's a nice application called HeadDress that gives a nice user interface for the whole process of setting up Virtual Hosts and it uses the Port based method to do so. You can use a nice interface to add a new site, pick the Port number and set a few other settings and HeadDress will add the correct virtual host for you. The only slight problem on Leopard is that the virtual host config should be set in the specific '/etc/apache2/extra/httpd-vhosts.conf' config file but HeadDress adds the hosts to the main 'httpd.conf' file instead as this is how it was done in Tiger's installation of Apache. Not a big deal but I'd prefer it if it wrote the to the right file. I just edit my hosts manually anyway but it'd be nice if the HeadDress developers update the app to use the correct conf file.

HeadDress allows you to set up a couple of sites for free or pay $14.95 for a full licence and as many sites as possible.