The Apache web server is the most popular way of serving web content on the internet. It accounts for more than half of all active websites on the internet and is extremely powerful and flexible.
Apache breaks its functionality and components into individual units that can be customized and configured independently. The basic unit that describes an individual site or domain is called a virtual host
.
These designations allow the administrator to use one server to host multiple domains or sites off of a single interface or IP by using a matching mechanism. This is relevant to anyone looking to host more than one site off of a single server.
Each domain that is configured will direct the visitor to a specific directory holding that site’s information, never indicating that the same server is also responsible for other sites. This scheme is expandable without any software limit as long as your server can handle the load.
In this guide, we will walk you through how to set up Apache virtual hosts on an Ubuntu 16.04 server. During this process, you’ll learn how to serve different content to different visitors depending on which domains they are requesting.
Before you begin this tutorial, you should create a sudo-enabled non-root user as described in steps 1–4 here.
You will also need to have Apache installed in order to work through these steps. If you haven’t already done so, you can get Apache installed on your server through apt-get
:
After these steps are complete, we can get started.
For the purposes of this guide, our configuration will make a virtual host for example.com
and another for test.com
. These will be referenced throughout the guide, but you should substitute your own domains or values while following along.
We will show how to edit your local hosts file later on to test the configuration if you are using dummy values. This will allow you to test your configuration from your home computer, even though your content won’t be available through the domain name to other visitors.
The first step that we are going to take is to make a directory structure that will hold the site data that we will be serving to visitors.
Our document root
(the top-level directory that Apache looks at to find content to serve) will be set to individual directories under the /var/www
directory. We will create a directory here for both of the virtual hosts we plan on making.
Within each of these directories, we will create a public_html
folder that will hold our actual files. This gives us some flexibility in our hosting.
For instance, for our sites, we’re going to make our directories like this:
The portions in red represent the domain names that we are wanting to serve from our VPS.
Now we have the directory structure for our files, but they are owned by our root user. If we want our regular user to be able to modify files in our web directories, we can change the ownership by doing this:
The $USER
variable will take the value of the user you are currently logged in as when you press ENTER
. By doing this, our regular user now owns the public_html
subdirectories where we will be storing our content.
We should also modify our permissions a little bit to ensure that read access is permitted to the general web directory and all of the files and folders it contains so that pages can be served correctly:
Your web server should now have the permissions it needs to serve content, and your user should be able to create content within the necessary folders.
We have our directory structure in place. Let’s create some content to serve.
We’re just going for a demonstration, so our pages will be very simple. We’re just going to make an index.html
page for each site.
Let’s start with example.com
. We can open up an index.html
file in our editor by typing:
In this file, create a simple HTML document that indicates the site it is connected to. The file looks like this:
<html>
<head>
<title>Welcome to Example.com!</title>
</head>
<body>
<h1>Success! The example.com virtual host is working!</h1>
</body>
</html>
Save and close the file when you are finished.
We can copy this file to use as the basis for our second site by typing:
We can then open the file and modify the relevant pieces of information:
<html>
<head>
<title>Welcome to Test.com!</title>
</head>
<body> <h1>Success! The test.com virtual host is working!</h1>
</body>
</html>
Save and close this file as well. You now have the pages necessary to test the virtual host configuration.
Virtual host files are the files that specify the actual configuration of our virtual hosts and dictate how the Apache web server will respond to various domain requests.
Apache comes with a default virtual host file called 000-default.conf
that we can use as a jumping off point. We are going to copy it over to create a virtual host file for each of our domains.
We will start with one domain, configure it, copy it for our second domain, and then make the few further adjustments needed. The default Ubuntu configuration requires that each virtual host file end in .conf
.
Start by copying the file for the first domain:
Open the new file in your editor with root privileges:
The file will look something like this (Comments have been removed here to make the file more approachable):
<VirtualHost *:80>
ServerAdmin webmaster@localhost
DocumentRoot /var/www/html
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
As you can see, there’s not much here. We will customize the items here for our first domain and add some additional directives. This virtual host section matches any requests that are made on port 80, the default HTTP port.
First, we need to change the ServerAdmin
directive to an email that the site administrator can receive emails through.
ServerAdmin admin@example.com
After this, we need to add two directives. The first, called ServerName
, establishes the base domain that should match for this virtual host definition. This will most likely be your domain. The second, called ServerAlias
, defines further names that should match as if they were the base name. This is useful for matching hosts you defined, like www
:
ServerName example.com
ServerAlias www.example.com
The only other thing we need to change for a basic virtual host file is the location of the document root for this domain. We already created the directory we need, so we just need to alter the DocumentRoot
directive to reflect the directory we created:
DocumentRoot /var/www/example.com/public_html
In total, our virtualhost file should look like this:
<VirtualHost *:80>
ServerAdmin admin@example.com
ServerName example.com
ServerAlias www.example.com
DocumentRoot /var/www/example.com/public_html
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
Save and close the file.
Now that we have our first virtual host file established, we can create our second one by copying that file and adjusting it as needed.
Start by copying it:
Open the new file with root privileges in your editor:
You now need to modify all of the pieces of information to reference your second domain. When you are finished, it may look something like this:
<VirtualHost *:80>
ServerAdmin admin@test.com
ServerName test.com
ServerAlias www.test.com
DocumentRoot /var/www/test.com/public_html
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
Save and close the file when you are finished.
Now that we have created our virtual host files, we must enable them. Apache includes some tools that allow us to do this.
We can use the a2ensite
tool to enable each of our sites like this:
Next, disable the default site defined in 000-default.conf
:
When you are finished, you need to restart Apache to make these changes take effect:
If you haven’t been using actual domain names that you own to test this procedure and have been using some example domains instead, you can at least test the functionality of this process by temporarily modifying the hosts
file on your local computer.
This will intercept any requests for the domains that you configured and point them to your server, just as the DNS system would do if you were using registered domains. This will only work from your computer though, and is simply useful for testing purposes.
Make sure you are operating on your local computer for these steps and not your server. You will need to know the computer’s administrative password or otherwise be a member of the administrative group.
If you are on a Mac or Linux computer, edit your local file with administrative privileges by typing:
If you are on a Windows machine, you can find instructions on altering your hosts file here.
The details that you need to add are the public IP address of your VPS server followed by the domain you want to use to reach that VPS.
For the domains that I used in this guide, assuming that my VPS IP address is 203.0.113.10
, I could add the following lines to the bottom of my hosts file:
127.0.0.1 localhost
127.0.1.1 guest-desktop
203.0.113.10 example.com
203.0.113.10 test.com
This will direct any requests for example.com
and test.com
on our computer and send them to our server at 203.0.113.10
. This is what we want if we are not actually the owners of these domains in order to test our virtual hosts.
Save and close the file.
Now that you have your virtual hosts configured, you can test your setup easily by going to the domains that you configured in your web browser:
http://example.com
You should see a page that looks like this:
Likewise, if you can visit your second page:
http://test.com
You will see the file you created for your second site:
If both of these sites work well, you’ve successfully configured two virtual hosts on the same server.
If you adjusted your home computer’s hosts file, you may want to delete the lines you added now that you verified that your configuration works. This will prevent your hosts file from being filled with entries that are not actually necessary.
If you need to access this long term, consider purchasing a domain name for each site you need and setting it up to point to your VPS server.
If you followed along, you should now have a single server handling two separate domain names. You can expand this process by following the steps we outlined above to make additional virtual hosts.
There is no software limit on the number of domain names Apache can handle, so feel free to make as many as your server is capable of handling.
Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.
This textbox defaults to using Markdown to format your answer.
You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!
I have configured the virtual host for example.com but still getting apache default page when i load the page.when i ping example.com i get the same IP that I configure in /etc/hosts.Have already disabled default page with a2dissite 000-default.conf. What could be the possible issue?
I have the same issue. It only works for me over SSL. I’ve posted on other sites asking for help fixing the issue.
If you are using SSL, you will have to keep the 000-default.conf enabled if you are letting your users visit your site with either http:// or https://. The 000-default.conf file acts as a catch all, and – as long as you have the proper redirect added in your virtual host file – all traffic will default to the https://.
Your config must have the “.conf” extension eg /etc/apache2/sites-available/example.com.conf
to get the result, you need Allow incoming traffic for this profile. Please follow this tutorial.
Example link
The tutorial works for me. Thanks
Question 1
[1] DocumentRoot /var/www/test.com/public_html
[2] DocumentRoot /var/www/test_com/public_html
which version is more better to use? Is it common practice to use dotted version?
Question 2 Once file
/etc/apache2/sites-available/test.com.conf
is changed, do I have re run$ sudo a2ensite test.com.conf
or not?Thanks!
Hi and thank you for the tutorials. I follow this instructions but when I try ping in console i receive the following:
64 bytes from sub-08.example.com (xxx.xx.xxx.xx): icmp_seq=8 ttl=64 time=0.059 ms
where do you thing I forget the example.com?
Could not get the new virtual server to see it’s DocumentRoot, it kept using the servers default yet it appeared to work: We put html docs in the users directories /home/bob/html adding DocumentRoot to each VirtualHost: <VirtualHost *> ServerName bob.fg DocumentRoot /home/bob/html <Directory /home/bob/html> allow from all Options Indexes FollowSymLinks AllowOverride None Require all granted
</Directory> </VirtualHost> Apache was not getting me to my DocumentRoot. After staring at the conf files I discovered webmin only put <VirtualHost *> instead of <VirtualHost *:80> made the change and it works now.
Thank you Brennen, this tutorial was perfect!
When I login with SFTP I can’t create folders inside the public_html folder but I can upload files or mofify them.
“example.com” folder and the “public_html” folder both have permission 755 and user is my user where I logon.
Any idea why I can’t create folders?
Step 5 I got this error, when I try to use “sudo a2ensite mydomain.com.conf”
perl: warning: Setting locale failed. perl: warning: Please check that your locale settings: LANGUAGE = (unset), LC_ALL = (unset), LC_CTYPE = “UTF-8”, LANG = “en_US.UTF-8” are supported and installed on your system. perl: warning: Falling back to a fallback locale (“en_US.UTF-8”). Enabling site mydomain.com. To activate the new configuration, you need to run: service apache2 reload
The same problem to me :(
This comment has been deleted
I have configured all the step from above.but still when i press “example.com”,Not Found
The requested URL / was not found on this server.
Be careful, people! If you get a “Not Found” / “The requested URL / was not found on this server.” response, then make sure your
DocumentRoot
directory is correct in yourexample.com.conf
file.I accidentally left the
/html/
part in the url that was there by default:If that doesn’t fix your “Not Found” problem, try this commant to check your apache logs:
hai, i have a quick question. why I unable to ping my virtualhost inside the server and also I unable to curl
Hi. I’m having some issues while creating the virtual host. The file located in sites-available is called repo.local.conf, and it looks like this:
This file was enabled using the procedure shown in this tutorial. The hosts file looks like this:
I did the “sudo chown -R $USER:$USER RepoUbuntu/” thing from Tools folder, and also gave it 777 permissions.
After restarting apache2 service, I’m getting this message:
Does anyone knows where did i go wrong? Please help :).
Nice article.
I have one question. Why when changing ownership of the folders, do we set the ownership to;
I thought it should be set to
I have seen that somewhere else, and wasn’t too sure what the “www-data” stands for.
Also as I only need to use these virtual machines locally when I open up my hosts file;
I point the domains to my localhost IP address like so;
This worked well for me.
How to use my username and my group instead of www-data user and group? When I going to change these values:
to
in the ‘envvars’ file, doesn’t works. Apparently php7 doesn’t work correctly if these changes are made.
Better yet: How to use multiple users and groups with permissions differents to www-data using virtualhost?
Thanks for help.
Hi, I have a quick question. I have a domain running under the default /www/html and would like to add another domain, how do you accomplish this without moving the default site or do I have to move the default page when I add a second domain?
Hi, this doesn’t work for me. When i opened the http://test.com, it directd me to https://www.test.com with a notification: 462 Forbidden Region: Your request for this resource had been blocked. This resource is not available in your region.
DOSarrest Internet Security is a cloud based fully managed DDoS protection service. This request has been blocked by DOSarrest due to the above violation. If you believe you are getting blocked in error please contact the administrator of www.test.com to resolve this issue.
In case of http://example.com, it showed: Example Domain
This domain is established to be used for illustrative examples in documents. You may use this domain in examples without prior coordination or asking for permission.
More information…
Any ideas?
For me www doesn’t work only http:// does
I followed these instructions with two domains that I own. The first domain serves fine when I browse to http://www.domain1.org. The second one always returns the default page from /var/www/html even when I browse to http://www.domain2.com. I ran a2dissite 000-default.conf and restarted Apache, but get the same behavior.
apache2ctl -S returns this:
AH00558: apache2: Could not reliably determine the server’s fully qualified domain name, using 127.0.1.1. Set the ‘ServerName’ directive globally to suppress this message VirtualHost configuration: *:80 is a NameVirtualHost default server domain1.org (/etc/apache2/sites-enabled/domain1.org.conf:1) port 80 namevhost domain1.org (/etc/apache2/sites-enabled/domain1.org.conf:1) alias www.domain1.org port 80 namevhost domain2.com (/etc/apache2/sites-enabled/domain2.com.conf:1) alias www.domain2.com ServerRoot: “/etc/apache2” Main DocumentRoot: “/var/www/html” Main ErrorLog: “/var/log/apache2/error.log” Mutex default: dir=“/var/run/apache2/” mechanism=default Mutex watchdog-callback: using_defaults PidFile: “/var/run/apache2/apache2.pid” Define: DUMP_VHOSTS Define: DUMP_RUN_CFG User: name=“www-data” id=33 Group: name=“www-data” id=33
Any idea why this is happening?
I’ve follow everything to the letter sudo a2ensite olmacdoanldsfarm.com /var/www/html already enabled sudo a2ensite peapatchrvpark.com /var/www/peapatch/ already enabled sudo a2ensite redpoppyrentalhall.com /var/www/redpoppy/ already enabled sudo dissite default already disabled etc/hosts 127.0.0.1 olmacds localhost 192.168.1.29 olmacdonaldsfarm.com 192.168.1.29 peapatchrvpark.com 192.168.1.29 redpoppyrentalhall.com
192.168.1.29 is the address of my server on my private network 65.245.187.152 is the address of my public ip it serves olmacdonaldsfarm.com just fine not the other two
ive tried everything I have given up
Be careful, people! If you get a “Not Found” / “The requested URL / was not found on this server.” response, then make sure your
DocumentRoot
directory is correct in yourexample.com.conf
file.I accidentally left the
/html/
part in the url that was there by default:If that doesn’t fix your “Not Found” problem, try this commant to check your apache logs:
hai, i have a quick question. why I unable to ping my virtualhost inside the server and also I unable to curl
Hi. I’m having some issues while creating the virtual host. The file located in sites-available is called repo.local.conf, and it looks like this:
This file was enabled using the procedure shown in this tutorial. The hosts file looks like this:
I did the “sudo chown -R $USER:$USER RepoUbuntu/” thing from Tools folder, and also gave it 777 permissions.
After restarting apache2 service, I’m getting this message:
Does anyone knows where did i go wrong? Please help :).
Nice article.
I have one question. Why when changing ownership of the folders, do we set the ownership to;
I thought it should be set to
I have seen that somewhere else, and wasn’t too sure what the “www-data” stands for.
Also as I only need to use these virtual machines locally when I open up my hosts file;
I point the domains to my localhost IP address like so;
This worked well for me.
How to use my username and my group instead of www-data user and group? When I going to change these values:
to
in the ‘envvars’ file, doesn’t works. Apparently php7 doesn’t work correctly if these changes are made.
Better yet: How to use multiple users and groups with permissions differents to www-data using virtualhost?
Thanks for help.
Hi, I have a quick question. I have a domain running under the default /www/html and would like to add another domain, how do you accomplish this without moving the default site or do I have to move the default page when I add a second domain?
Hi, this doesn’t work for me. When i opened the http://test.com, it directd me to https://www.test.com with a notification: 462 Forbidden Region: Your request for this resource had been blocked. This resource is not available in your region.
DOSarrest Internet Security is a cloud based fully managed DDoS protection service. This request has been blocked by DOSarrest due to the above violation. If you believe you are getting blocked in error please contact the administrator of www.test.com to resolve this issue.
In case of http://example.com, it showed: Example Domain
This domain is established to be used for illustrative examples in documents. You may use this domain in examples without prior coordination or asking for permission.
More information…
Any ideas?
For me www doesn’t work only http:// does
I followed these instructions with two domains that I own. The first domain serves fine when I browse to http://www.domain1.org. The second one always returns the default page from /var/www/html even when I browse to http://www.domain2.com. I ran a2dissite 000-default.conf and restarted Apache, but get the same behavior.
apache2ctl -S returns this:
AH00558: apache2: Could not reliably determine the server’s fully qualified domain name, using 127.0.1.1. Set the ‘ServerName’ directive globally to suppress this message VirtualHost configuration: *:80 is a NameVirtualHost default server domain1.org (/etc/apache2/sites-enabled/domain1.org.conf:1) port 80 namevhost domain1.org (/etc/apache2/sites-enabled/domain1.org.conf:1) alias www.domain1.org port 80 namevhost domain2.com (/etc/apache2/sites-enabled/domain2.com.conf:1) alias www.domain2.com ServerRoot: “/etc/apache2” Main DocumentRoot: “/var/www/html” Main ErrorLog: “/var/log/apache2/error.log” Mutex default: dir=“/var/run/apache2/” mechanism=default Mutex watchdog-callback: using_defaults PidFile: “/var/run/apache2/apache2.pid” Define: DUMP_VHOSTS Define: DUMP_RUN_CFG User: name=“www-data” id=33 Group: name=“www-data” id=33
Any idea why this is happening?
I’ve follow everything to the letter sudo a2ensite olmacdoanldsfarm.com /var/www/html already enabled sudo a2ensite peapatchrvpark.com /var/www/peapatch/ already enabled sudo a2ensite redpoppyrentalhall.com /var/www/redpoppy/ already enabled sudo dissite default already disabled etc/hosts 127.0.0.1 olmacds localhost 192.168.1.29 olmacdonaldsfarm.com 192.168.1.29 peapatchrvpark.com 192.168.1.29 redpoppyrentalhall.com
192.168.1.29 is the address of my server on my private network 65.245.187.152 is the address of my public ip it serves olmacdonaldsfarm.com just fine not the other two
ive tried everything I have given up