User-based Directories¶

• Table of contents
• User-based Directories
  • Description
  • Options
    • userdir.path (required option)
    • userdir.exclude-user
    • userdir.include-user
    • userdir.basepath

Module mod_userdir

Description¶

The userdir module provides a simple way to link user-based directories into the global namespace of the webserver.

Requests in the form /~user/page.html are rewritten to take the file page.html from the home directory of the user.
If userdir.path is set, the path will be appended to the home directory building the classic mapping of:

# URL: http://www.example.org/~jan/index.html 
# Path: /home/jan/public_html/

userdir.path = "public_html" 

To control which users should be able to use this feature you can set a list of usernames to include or exclude.

In case your mapping is independent of /etc/passwd you can use userdir.basepath:

# URL: http://www.example.org/~jan/index.html
# Path: /var/www/users/jan/htdocs/index.html

userdir.path = "htdocs" 
userdir.basepath = "/var/www/users/" 

Options¶

userdir.path (required option)¶

usually it should be set to "public_html" to take ~/public_html/ as the document root
default: unset (mod_userdir disabled; set it to "" if you want the home directory to be the document root as it was the default before 1.4.19)
Example:

userdir.path = "public_html"

userdir.exclude-user¶

list of usernames which may not use this feature
default: empty (all users may use it)
Example:

userdir.exclude-user = ( "root", "postmaster" )

userdir.include-user¶

if set, only users from this list may use the feature
default: empty (all users may use it)

userdir.basepath¶

if set, don't check /etc/passwd for homedir