How do I change the root directory of an Apache server?

LinuxApacheLamp

Linux Problem Overview


How can I change the document root of the Apache server? I basically want localhost to come from /users/spencer/projects directory instead of /var/www.


I ended up figuring it out. Some suggested I change the httpd.conf file, but I ended up finding a file in /etc/apache2/sites-available/default and changed the root directory from /var/www to /home/myusername/projects_folder and that worked.

Linux Solutions


Solution 1 - Linux

Please note, that this only applies for Ubuntu 14.04 LTS (Trusty Tahr) and newer releases.

In my Ubuntu 14.04 LTS, the document root was set to /var/www/html. It was configured in the following file:

/etc/apache2/sites-available/000-default.conf

So just do a

sudo nano /etc/apache2/sites-available/000-default.conf

and change the following line to what you want:

DocumentRoot /var/www/html

Also do a

sudo nano /etc/apache2/apache2.conf

and find this:

<Directory /var/www/html/>
Options Indexes FollowSymLinks
AllowOverride None
Require all granted
</Directory>

And change /var/www/html to your preferred directory and save it.

After you saved your changes, just restart the Apache 2 web server and you'll be done :)

sudo service apache2 restart


If you prefer a graphical text editor, you can just replace the sudo nano with a gksu gedit.

Solution 2 - Linux

You need to change the DocumentRoot setting in your httpd.conf file. Chances are it will be under something like /etc/apache2/conf/httpd.conf.

Use your favourite editor (I recommend Vim) and look for the DocumentRoot and change it to /users/spencer/projects. Also look a little further down for a setting that looks like this:

<Directory "/var/www">

You will also want to change what is in the quotes to your new directory. This gives Apache access to read from that directory when a user makes a request that call on it.

Now restart your Apache service (httpd -k restart) and you should be good to go.

Apache 2 site configuration files are now typically kept in /etc/apache2/sites-available/ (Debian, Ubuntu, etc.).

Solution 3 - Linux

I had to edit /etc/apache2/sites-available/default. The lines are the same as mentioned by RDL.

Solution 4 - Linux

This is for Ubuntu 14.04 (Trusty Tahr):

In file /etc/apache2/apache2.conf it should be as below without the directory name:

<Directory /home/username>
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

And in file /etc/apache2/sites-available/000-default.conf you should include the custom directory name, i.e., www:

DocumentRoot /home/username/www

If it is not as above, it will give you an error when loading the server:

> Forbidden You don't have permission to access / on this server

Solution 5 - Linux

The right way to change directory or run from multiple directories under different port for Apache 2 is as follows:

For Apache 2, the configuration files are located under /etc/apache2 and doesn’t use a single configuration file as in older versions but is split into smaller configuration files, with /etc/apache2/apache2.conf being the main configuration file. To serve files from a different directory we need a new virtualhost conf file. The virtualhost configuration files are located in /etc/apache2/sites-available (do not edit files within sites-enabled). The default Apache installation uses virtualhost conf file 000-default.conf.

Start by creating a new virtualhost file by copying the default virtualhost file used by the default installation of Apache (the one that runs at localhost on port 80). Change into directory /etc/apache2/sites-available and then make copy by sudo cp 000-default.conf example.com.conf, now edit the file by sudo gedit example.com.conf to:

<VirtualHost *:80>
    ServerAdmin example@localhost
    DocumentRoot /home/ubuntu/example.com
</VirtualHost>

I have deleted the nonimportant lines from the above file for brevity. Here DocumentRoot is the path to the directory from which the website files are to be served such as index.html.

Create the directory from which you want to serve the files, for example, mkdir example.com and change owner and default group of the directory, for example, if your logged in user name is ubuntu change permissions as sudo chown ubuntu:www-data example.com. This grants full access to the user ubuntu and allows read and execute access to the group www-data.

Now edit the Apache configuration file /etc/apache2/apache2.conf by issuing command sudo gedit apache2.conf and find the line <Directory /var/www/> and below the closing tag </Directory>, add the following below:

<Directory /home/ubuntu/example.com>
    Options Indexes FollowSymLinks Includes ExecCGI
    AllowOverride All
    Require all granted
</Directory>

Now there are two commands to enable or disable the virtualhost configuration files, which are a2ensite and a2dissite respectively. Now since our example.com.conf file uses the same port(80) as used by the default configuration file(000-default.conf), we have to disable the default configuration file by issuing the command sudo a2dissite 000-default.conf and enable our virtualhost configuration file by sudo a2ensite example.com.conf

Now restart or reload the server with command sudo service apache2 restart. Now Apache serves files from directory example.com at localhost on default port of 80.

The a2ensite command basically creates a symbolic link to the configuration file under the site-enabled directory.

Do not edit files within sites-enabled (or *-enabled) directory, as pointed out in this answer.

To change the port and run from multiple directories on different ports:

Now if you need to run the directory on a different port, change the port number from 80 to 8080 by editing the virtualhost file as:

<VirtualHost *:8080>
    ServerAdmin user@localhost
    DocumentRoot /home/ubuntu/work
</VirtualHost>

and editing /etc/apache2/ports.conf and adding Listen 8080 just below the line Listen 80

Now we can enable the default virtualhost configuration file that runs on port 80 since example.com directory uses port 8080, as sudo a2ensite 000-default.conf.

Now restart or reload the server with command sudo service apache2 restart. Now both the directories can be accessed from localhost and localhost:8080.

Solution 6 - Linux

If you couldn't find http.conf and followed Nick's way.

Restart Apache using sudo service apache2 restart.

Solution 7 - Linux

I was working with LAMP and to change the document root folder, I have edited the default file which is there in the /etc/apache2/sites-available folder.

If you want to do the same, just edit as follows:

DocumentRoot /home/username/new_root_folder
    <Directory />
        Options FollowSymLinks
        AllowOverride None
    </Directory>
    <Directory /home/username/new_root_folder>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride None
        Order allow,deny
        allow from all
    </Directory>

After this, if you type "localhost" in the browser, it will load the /home/username/new_root_folder content.

Solution 8 - Linux

For Apache 2 on Linux Mint 17.3 Cinnamon 64-bit, the following works:

  1. In /etc/apache2/sites-available/ open the 000-default.conf file, and change the Document Root to the absolute path of your directory.

    sudo vim /etc/apache2/sites-available/000-default.conf

  2. In folder /etc/apache2/ open file httpd.conf, and add a <Directory> tag referencing your directory and containing the exact same settings as the tag for var/www.

     sudo vim /etc/apache2/apache2.conf
    

    On my machine it looked like this:


     <Directory /home/my_user_name/php/>
             Options Indexes FollowSymLinks
             AllowOverride All
             Require all granted
     </Directory>
    

Note: In the first step you probably want to change Document Root in the default-ssl.conf file as well for SSL purposes. But as far as I can tell, this isn't required to get a general development environment running.

Solution 9 - Linux

In Apache version 2.4.18 (Ubuntu).

  1. Open the file /etc/apache2/apache2.conf and search for <Directory /var/www/> and replace to your directory.

  2. Open file /etc/apache2/sites-available/000-default.conf, search for DocumentRoot /var/www/html and replace it with your DocumentRoot.

Solution 10 - Linux

In case you are using Ubuntu 16.04 (Xenial Xerus), please update the 000-default.conf file in the directory /etc/apache2/sites-available.

Here →

ServerAdmin webmaster@localhost
DocumentRoot /var/www/html/YourFolder

Solution 11 - Linux

The following applies to Ubuntu 14.04 (Trusty Tahr) and later releases. Make sure to back up following files before making any changes.

  1. Open /etc/apache2/apache2.conf and search for <Directory /var/www/> directive and replace path with /home/<USERNAME>/public_html. You can use * instead of .

  2. Open /etc/apache2/sites-available/000-default.conf and change the DocumentRoot value property from /var/www/html to /home/<USERNAME>/public_html. Also <Directory /var/www/html> to <Directory /home/<USERNAME>/public_html.

  3. Open /etc/mods-available/php7.1.conf. Find and comment the following code

    php_admin_flag engine Off

Do not turn the php_admin_flag engine OFF flag on as the reason is mentioned in a comment above the Directive code. Also the PHP version can be 5.0, 7.0 or anything you have installed.

Create public_html directory in home/<USERNAME>.

Restart the Apache service by executing command sudo service apache2 restart.

Test by running a sample script on the server.

Solution 12 - Linux

I had made the /var/www to be a soft link to the required directory (for example, /users/username/projects) and things were fine after that.

However, naturally, the original /var/www needs to be deleted - or renamed.

Solution 13 - Linux

If someone has installed LAMP in the /opt folder, then the /etc/apache2 folder is not what you are looking for.

Look for httpd.conf file in folder /opt/lampp/etc.

Change the line in this folder and save it from the terminal.

Solution 14 - Linux

In Red Hat Linux 7.0: /etc/httpd/conf/httpd.conf

Solution 15 - Linux

If you're using Linux Mint (personal opinion, from all distributions this one is making me happy), follow this:

  1. Go to folder /etc/apache2/sites-available and edit file 000-default.conf.
  2. Search for DocumentRoot, example DocumentRoot /var/www/html. You change to your respective directory;
  3. Open a terminal and type: sudo service apache2 restart

In Linux Mint, you go for file /etc/apache2/apache.conf. Replace /var/www with your respective path, and then restart the server (step 3).

That's it.

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
QuestionSpencer CooleyView Question on Stackoverflow
Solution 1 - LinuxmozzbozzView Answer on Stackoverflow
Solution 2 - LinuxRDLView Answer on Stackoverflow
Solution 3 - LinuxNickView Answer on Stackoverflow
Solution 4 - LinuxandrosfatView Answer on Stackoverflow
Solution 5 - LinuxlordvcsView Answer on Stackoverflow
Solution 6 - LinuxNitinView Answer on Stackoverflow
Solution 7 - LinuxShashidharaView Answer on Stackoverflow
Solution 8 - LinuxstackatoView Answer on Stackoverflow
Solution 9 - LinuxhabibunView Answer on Stackoverflow
Solution 10 - LinuxShashank SaxenaView Answer on Stackoverflow
Solution 11 - Linuxuser1184294View Answer on Stackoverflow
Solution 12 - Linuxmaan81View Answer on Stackoverflow
Solution 13 - LinuxYogesh GuptaView Answer on Stackoverflow
Solution 14 - LinuxehacinomView Answer on Stackoverflow
Solution 15 - LinuxMarcelo AgimóvelView Answer on Stackoverflow