Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
57 lines (36 sloc) 2.62 KB

DocumentRoot

Publish

In order for a website to be accessible to visitors, it must be published to the correct directory. :ref:`Upload your files via SFTP <sftp>` and place them in /var/www/virtual/<username>/html. Access the files via :ref:`your domain <web-domains>`.

Additional DocumentRoots

Warning

We strongly suggest to use different accounts for different projects due to security reasons. If one of the DocumentRoots gets compromised (e.g. because of a CVE), all other files within all other DocumentRoots can be compromised as well.

You can create folders (and symlinks) in the form of /var/www/virtual/<username>/<domain>. Make sure :ref:`your domain <web-domains>` is setup and configured correctly. To use RewriteRules, you have to create a :ref:`.htaccess file <htaccess>` within the DocumentRoot with the following content:

RewriteBase /

Tip

The DOCUMENT_ROOT variable set by Apache always points to the one and only DocumentRoot /var/www/virtual/<username>/html so you will will get a misleading value. There is no way to change that behaviour.

Warning

Do not delete /var/www/virtual/<username>/html. If this folder doesn't exist, the RewriteRules implementing the additional DocumentRoots don't work, so all your domains will be unaccessable.

Permissions

Since the webserver runs with a different user, you need to make sure your files have the right permissions. The folder /var/www/virtual/<username>/html and all additional DocumentRoots need to have mode 0755, the files within 0644.

Tip

Since the folder /var/www/virtual/<username> has mode 0750, other users on the same server can't access your files.

Configuration

Provided configuration

We provide the following configuration:

DirectoryIndex index.html index.htm index.html.var index.php index.php5 index.cgi index.sh
TypesConfig /etc/mime.types
AddType application/x-compress .Z
AddType application/x-gzip .gz .tgz
AddType text/html .shtml
AddOutputFilter INCLUDES .shtml

Own configuration

You can provide your own configuration with .htaccess files. Check the Directive Quick Reference for possible configuration directives. Keep in mind that the third column needs to contain h for .htaccess.

You can’t perform that action at this time.