My hosting provider, HostMonster, uses cPanel to enable account administrators to configure their domains and services. By default, Hostmonster and cPanel place web data for the primary domain in ~/public_html/, with subdomains and “add-on” domains as subdirectories therein. That means that files for the primary domain are comingled with the document roots of other domains. The incongruency of that layout causes heartburn for people like me. This post tells you how to relocate those files AND have them served by the original URLs for the primary domain.

UPDATE: The following *mostly* works, but I’ve had yet unresolvable problems with directory URLs not being rewritten to append the /, which causes failure. A slow investigation is in progress…

There are several reasons why you might want relocate files for the primary domain. First, there’s the compulsive disorder desire for organization that provides better containment of files related to a site, and nothing else. Good organization often leads to reduced errors and improved efficiency (not accounting for the time it takes to blog about them). A second reason is that people might access one domain’s data through the URL of a primary domain, such as This isn’t a concern in my case, but it might be for others. (I do use this nesting in other contexts to make equivalent to, but that’ll be a different story.)

My original directory structure looked something like this:

$ ls ~/public_html
400.shtml		      401.shtml			    403.shtml
404.shtml		      500.php			    500.shtml
beaconcoaching		    cgi-bin	      fastphp.ini		    favicon.ico
home-exchange		      index.html		    nctgi
reece			      reece-ex-wp		    robots.txt
spat			      tahoe			    tmp

See how the the error pages, my subdirectory, and other primary domain files are scattered among the document roots that serve domains for Beacon Coaching, a development Genome Commons site, and Unison database? Yuk.

I prefer to name directories for the domains they serve, such as ~/public_html/ Sure, I could move the primary domain files there, but then they’d be served by URLs like [N.B. This is a bogus link that illustrates what I didn't want.] Preserve the original URLs is critical.

The solution is to move files for the primary domain into a dedicated directory and tell apache, via mod_rewrite rules in ~/public_html/.htaccess, where to look for primary domain files.

Specifically, I did this:

  1. ssh to the domain
  2. cd ~/public_html
  3. mkdir
  4. mv – [primary domain files]
  5. add the following stanza to ~/public_html/.htaccess:
RewriteEngine on

# rewrite requests for primary domain into
RewriteCond %{HTTP_HOST} ^(www\.)?harts\.net
RewriteCond %{REQUEST_URI} !^/
RewriteCond %{REMOTE_HOST} !
RewriteRule ^(.*)$ /$1 [L]

Notice the exception for SimpleScripts — without that, simplescripts will be unable to manage domain installations. (SimpleScripts is a terrific tool that greatly facilitates installing and upgrading many common blogging, CMS, forum, wiki, commerce, and customer service tools.)