Apache HTTP Server Version 2.0

Apache Module mod_userdir

Description: User-specific directories
Status: Base
Module Identifier: userdir_module


This module allows user-specific directories to be accessed using the http://example.com/~user/ syntax.


See also

UserDir Directive

Description: Location of the user-specific directories
Syntax: UserDir directory-filename
Default: UserDir public_html
Context: server config, virtual host
Status: Base
Module: mod_userdir

The UserDir directive sets the real directory in a user's home directory to use when a request for a document for a user is received. Directory-filename is one of the following:

If neither the enabled nor the disabled keywords appear in the Userdir directive, the argument is treated as a filename pattern, and is used to turn the name into a directory specification. A request for http://www.foo.com/~bob/one/two.html will be translated to:

UserDir directive used Translated path
UserDir public_html~bob/public_html/one/two.html
UserDir /usr/web/usr/web/bob/one/two.html
UserDir /home/*/www/home/bob/www/one/two.html

The following directives will send redirects to the client:

UserDir directive used Translated path
UserDir http://www.foo.com/usershttp://www.foo.com/users/bob/one/two.html
UserDir http://www.foo.com/*/usrhttp://www.foo.com/bob/usr/one/two.html
UserDir http://www.foo.com/~*/http://www.foo.com/~bob/one/two.html
Be careful when using this directive; for instance, "UserDir ./" would map "/~root" to "/" - which is probably undesirable. It is strongly recommended that your configuration include a "UserDir disabled root" declaration. See also the Directory directive and the Security Tips page for more information.

Additional examples:

To allow a few users to have UserDir directories, but not anyone else, use the following:

UserDir disabled
UserDir enabled user1 user2 user3

To allow most users to have UserDir directories, but deny this to a few, use the following:

UserDir enabled
UserDir disabled user4 user5 user6

Apache HTTP Server Version 2.0