public_html.xml revision e8811b6d38f756b325446ded5d96857d13856511
9f23530860942a8f94b7c535ead80c38f02424b1Lennart Poettering<!DOCTYPE manualpage SYSTEM "/style/manualpage.dtd">
12b42c76672a66c2d4ea7212c14f8f1b5a62b78dTom Gundersen<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
9f23530860942a8f94b7c535ead80c38f02424b1Lennart Poettering<!-- $LastChangedRevision$ -->
9f23530860942a8f94b7c535ead80c38f02424b1Lennart Poettering Licensed to the Apache Software Foundation (ASF) under one or more
9f23530860942a8f94b7c535ead80c38f02424b1Lennart Poettering contributor license agreements. See the NOTICE file distributed with
9f23530860942a8f94b7c535ead80c38f02424b1Lennart Poettering this work for additional information regarding copyright ownership.
9f23530860942a8f94b7c535ead80c38f02424b1Lennart Poettering The ASF licenses this file to You under the Apache License, Version 2.0
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering (the "License"); you may not use this file except in compliance with
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering the License. You may obtain a copy of the License at
9f23530860942a8f94b7c535ead80c38f02424b1Lennart Poettering http://www.apache.org/licenses/LICENSE-2.0
9f23530860942a8f94b7c535ead80c38f02424b1Lennart Poettering Unless required by applicable law or agreed to in writing, software
9f23530860942a8f94b7c535ead80c38f02424b1Lennart Poettering distributed under the License is distributed on an "AS IS" BASIS,
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
9f23530860942a8f94b7c535ead80c38f02424b1Lennart Poettering See the License for the specific language governing permissions and
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering limitations under the License.
9f23530860942a8f94b7c535ead80c38f02424b1Lennart Poettering<manualpage metafile="public_html.xml.meta">
9f23530860942a8f94b7c535ead80c38f02424b1Lennart Poettering<parentdocument href="./">How-To / Tutorials</parentdocument>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>Per-user web directories</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek<p>On systems with multiple users, each user can be permitted to have a
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek web site in their home directory using the <directive
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek module="mod_userdir">UserDir</directive> directive. Visitors
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek to a URL <code>http://example.com/~username/</code> will get content
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek out of the home directory of the user "<code>username</code>", out of
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the subdirectory specified by the <directive
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek module="mod_userdir">UserDir</directive> directive.</p>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek<p>Note that, by default, access to these directories is <strong>not</strong>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek enabled. You can enable access when using <directive module="mod_userdir"
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek >UserDir</directive> by uncommenting the line</p>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek #Include conf/extra/httpd-userdir.conf
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <p>in the default config file, and adapting the <code
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek file as necessary, or by including the appropriate directives in a
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <code>Directory</code> block within the main config file.</p>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek<seealso><a href="/urlmapping.html">Mapping URLs to the Filesystem</a></seealso>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>Per-user web directories</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <directive module="mod_userdir">UserDir</directive>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <directive module="core">DirectoryMatch</directive>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <directive module="core">AllowOverride</directive>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </directivelist>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>Setting the file path with UserDir</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <p>The <directive module="mod_userdir">UserDir</directive>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek directive specifies a directory out of which per-user
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek content is loaded. This directive may take several different forms.</p>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <p>If a path is given which does not start with a leading slash, it is
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek assumed to be a directory path relative to the home directory of the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek specified user. Given this configuration:</p>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek UserDir public_html
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <p>the URL <code>http://example.com/~rbowen/file.html</code> will be
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek translated to the file path
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <code>/home/rbowen/public_html/file.html</code></p>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <p>If a path is given starting with a slash, a directory path will be
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek constructed using that path, plus the username specified. Given this
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek configuration:</p>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <p>the URL <code>http://example.com/~rbowen/file.html</code> will be
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek translated to the file path <code>/var/html/rbowen/file.html</code></p>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <p>If a path is provided which contains an asterisk (*), a path is used
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek in which the asterisk is replaced with the username. Given this
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek configuration:</p>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <p>the URL <code>http://example.com/~rbowen/file.html</code> will be
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek translated to the file path
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <code>/var/www/rbowen/docs/file.html</code></p>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <p>Multiple directories or directory paths can also be set.</p>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <p>For the URL <code>http://example.com/~rbowen/file.html</code>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek Apache will search for <code>~rbowen</code>. If it isn't found,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek Apache will search for <code>rbowen</code> in <code>/var/html</code>. If
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek found, the above URL will then be translated to the file path
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <code>/var/html/rbowen/file.html</code></p>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>Redirecting to external URLs</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <p>The <directive module="mod_userdir">UserDir</directive> directive can be
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek used to redirect user directory requests to external URLs.</p>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek UserDir http://example.org/users/*/
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <p>The above example will redirect a request for
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <code>http://example.com/~bob/abc.html</code> to
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <code>http://example.org/users/bob/abc.html</code>.</p>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>Restricting what users are permitted to use this
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <p>Using the syntax shown in the UserDir documentation, you can restrict
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek what users are permitted to use this functionality:</p>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek UserDir enabled<br />
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek UserDir disabled root jro fish
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <p>The configuration above will enable the feature for all users
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek except for those listed in the <code>disabled</code> statement.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek You can, likewise, disable the feature for all but a few users by
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek using a configuration like the following:</p>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek UserDir disabled<br />
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek UserDir enabled rbowen krietz
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <p>See <directive module="mod_userdir">UserDir</directive>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek documentation for additional examples.</p>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>Enabling a cgi directory for each user</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <p>In order to give each user their own cgi-bin directory, you can use
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek a <directive module="core" type="section">Directory</directive>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek directive to make a particular subdirectory of a user's home directory
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek cgi-enabled.</p>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <Directory /home/*/public_html/cgi-bin/><br />
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek Options ExecCGI<br />
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek SetHandler cgi-script<br />
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </Directory>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <p>Then, presuming that <code>UserDir</code> is set to
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <code>public_html</code>, a cgi program <code>example.cgi</code>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek could be loaded from that directory as:</p>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek http://example.com/~rbowen/cgi-bin/example.cgi
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>Allowing users to alter configuration</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <p>If you want to allows users to modify the server configuration in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek their web space, they will need to use <code>.htaccess</code> files to
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek make these changed. Ensure that you have set <directive
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek module="core">AllowOverride</directive> to a
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek value sufficient for the directives that you want to permit the users
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek to modify. See the <a href="htaccess.html">.htaccess tutorial</a> for
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek additional details on how this works.</p>