Use "Domains > Remap Sub-Dir" to make a sub-directory of your domain use a non-standard location in your file system its source for web content.Normally if you have
http://www.domain.com/ set up with the web directory /home/user/domain.comthen
http://www.domain.com/pictures/ would get its content from /home/user/domain.com/pictures automatically.This area allows you to override this default setting and use any folder you'd like to provide content for sub-directories of your domain.
http://www.domain.com/pictures/ could get its content from /home/user/domain.com/data/media/pictures automatically.
VPS and dedicated server peeps can use this to get around the One User Per Domain Policy and share a domain among multiple ftp users. Meaning, you can assign folders under your domain to other FTP users. Note, however, that the directory you remap will only be accessible by the user you remapped it to. Not even the 'main' domain user will be able to access it.Now you could have:
http://www.domain.com/pictures/ get its content from /home/otheruser/images
You can't use this area to change the web directory for an entire domain! To do that, just go to the "edit" link at "Domains > Web".
CGI scripts won't work in sub-directories remapped to other user's home directories because of file ownership issues (error caused by a simple Python CGI script in a remapped sub-directory):
[Sun Mar 20 08:02:09 2011] [error] [client xx.xxx.xxx.xxx] suexec failure: could not open log file [Sun Mar 20 08:02:09 2011] [error] [client xx.xxx.xxx.xxx] fopen: Permission denied [Sun Mar 20 08:02:09 2011] [error] [client xx.xxx.xxx.xxx] Premature end of script headers: test.cgi
PHP scripts won't work in sub-directories remapped to other user's home directories because of a PHP security update DreamHost admins implemented in March 2012. Trying to run a script across users just loads a blank page with "No input file specified".
Note also that PHP scripts in remapped sub-directories - within your own home directory - can only run with the server's default PHP version.
Lighttpd on DreamHost PS
When using URL remapping on DreamHost PS together with Lighttpd and you are remapping to a different user you must not enable the enhanced security feature on the new user in order for the remap to work.