Apache Root Directory (DocumentRoot)
Apache root directory or web root directory is the folder location on the filesystem that the web server uses to serve files from, for a given request. It can be specified inside the
<VirtualHost> block/container or outside it (main server config) using the
DocumentRoot directive. From the documentation:
This directive sets the directory from which
httpdwill serve files. Unless matched by a directive like
Alias, the server appends the path from the requested URL to the document root to make the path to the document.
The important bit is that the server appends incoming request path to the document root to find the path to the document or file that has to be served. So if a virtual host for
example.com points to
DocumentRoot /var/www/html then for
example.com/foo/bar.htm, Apache will serve
Few things to note here:
- If the directory path passed to
DocumentRootis not absolute (or relative) then it is assumed relative to the server root.
- If the virtual host block lacks a
DocumentRootdirective, then the default root directory is used.
How can I change the root directory ?
There are a bunch of options.
- Find the virtual host block in use for your website and then either set or change the
- Find the location for your main server config file (
apache2.conf) and set or change the
DocumentRootpath there to modify the default root directory.
Based on the operating system in use, you need to find the virtual host file (for 1) or main server config file (for 2) and add or change
DocumentRoot with the desired value.
# Something like the following: # Old Value DocumentRoot /var/www/html # New Value DocumentRoot /home/codingshower/html
On this page, you can check where these files can be found for default httpd installations across different unix-based or unix-like systems (Ubuntu, Debian, CentOS, Fedora, FreeBSD, macOS).
Note: For any change made to
DocumentRoot, you may have to change the respective
<Directory> block’s path as well.
Do not forget to restart apache after making any config changes with any of the following command that works for you (will most likely need a
$ service apache2 restart $ service httpd restart $ systemctl restart apache2 $ systemctl restart httpd $ systemctl restart httpd.service $ apachectl restart $ httpd restart