Project

General

Profile

User-based Directories

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