Redirecting subdomains to directories in apache.

Note: It is likely you will need root access to carry out apache config alterations 12-02-07: Fixed mistake in the directory comparison line.

If you want to be able to redirect to so that is shown in the address bar here's a quick and dirty how to:

First off if you want any subdomain to be able to be redirected first you need to set-up your DNS correctly. In my case this was as simple as going to the people that host my domain and adding an A record with the wildcard * that pointed to my server's ip address. Bear in mind your DNS settings may take a while to work so be patient. Before you proceed you should check that resolves to the ip address of your server. You can check this by running:


This should respond with something like this:

[root@cheekymonkey conf]# ping
PING ( 56(84) bytes of data.
64 bytes from ( icmp_seq=0 ttl=64 time=0.058 ms
64 bytes from ( icmp_seq=1 ttl=64 time=0.040 ms
64 bytes from ( icmp_seq=2 ttl=64 time=0.071 ms
64 bytes from ( icmp_seq=3 ttl=64 time=0.028 ms

The next step is to set-up the virtual host to respond to the wildcard subdomains. In the case of plesk you have to set-up a vhost.conf file but on any other apache installation you can just edit httpd.conf and look for the <VirtualHost> that corresponds to your site. If you are using Plesk you will need to ssh in to your server and create a vhost.conf file if it doesn't already exist here where <> is your domain:


Open that file with the command line editor of your choice and add the following directives:

ServerAlias *
RewriteEngine on
RewriteCond %{HTTP_HOST} !^www.* [NC]
RewriteCond %{HTTP_HOST} ^([^\.]+)\.domain\.com
RewriteCond /var/www/vhosts/ -d
RewriteRule ^(.*) /%1/$1 [L]

Substitute for your domain. Now here's a quick walkthrough how these rules work. The first line ServerAlias * tells apache to accept

Next the rewrite rules work as follows:

  1. The first line of mod_rewrite !^www.* only matches urls that don't begin with www. You don't want to redirect to do you? Note: you could add additional lines like these to prevent re-writing other subdomains like if that should not be redirected to
  2. The second line ^([^\.]+)\.*$ captures into a backreference anything that doesn't have a period e.g. the subdomain. The plus makes sure that there is at least one character that matches.
  3. The next condition checked is that the directory captured into the backreference does actually exist hence the -d.
  4. This last line ^(.*) /%1/$1 [L] takes the requested path and dumps it into a back reference and then rewrites it to point to the a directory (the subdomain backreference captured in the Rewrite conditions above) . In other words %1 is the subdomain backreference and $1 is the path backreference (that captured by .*). The important thing to rember is you can refer to backreferences in rewriteCond lines with % and backreferences in rewriteRules with $. Lastly the [L] (last) means doen't further rewrite this URL. Note: You might want to leave this out if you are doing any subsequent rewrites, be sure to test what you have set-up thoroughly!!!

Now once you have made those changes if you are running plesk you will need to apply your vhost.conf changes with the following command:

/usr/local/psa/admin/sbin/websrvmng --reconfigure-vhost --vhost-name=<>

And then whether are using Plesk or not you need to restart apache e.g:

service httpd restart

Now you should find that if you set-up a directory called "meegan" with a valid index.html file in it. should find that file. The job's a good'un.

comments powered by Disqus