Configure vhosts on a LAMP stack
Whether you host a single site, or dozens of sites on your new Linux® Apache® MySQL® PHP® (LAMP) server, virtual hosts (vhosts) help you efficiently organize your sites.
In the following example, the LAMP server is already configured to serve content directly from the /var/www/html directory in the example below:
/var/www ├── html │ └── index.html └── vhosts
The existing index.html file is the standard Apache test page. You can immediately serve content by replacing the existing file with your own site files. Alternatively, you can serve one or more sites by using vhosts. Your LAMP stack contains a template that you can modify to create new vhost configuration files for each site that you need to host.
How to configure vhosts
Note: On the Ubuntu® operating system, each vhost has its own separate configuration file, and is then enabled in Apache.
Use the following instructions to configure your vhosts:
Note: Replace yoursitename.com in the instructions below with your actual site or domain name. We recommend that you use the top-level domain such as .com, .net, and so on on one server.
Navigate to the sites-available folder by using the following command:
$ cd /etc/apache2/sites-available
Find and replace the default site name, example.com, in the default.template file by using the
sedstream editor and the following commands:
Test the output by using the following command:
$ sed -e 's/example.com/yoursitename.com/' default.template
Write the changes to a new vhost for this file by using the following command:
$ sed -e 's/example.com/yoursitename.com/' default.template > yoursitename.com.conf
Verify that the file was written with the proper project name by using the following command:
$ cat yoursitename.com.conf
Add the project to the list of available sites in the Apache configuration file by using the following command:
$ a2ensite yoursitename.com.conf
Create the directory for your site by using the following command:
$ mkdir -p /var/www/vhosts/yoursitename.com
Note: The vhost that you made previously is configured to look in this directory.
Repeat steps 1 - 4 to add additional vhosts.
Test your vhost configuration
This test should produce a response of
Syntax OK. Test the configuration by using the following command:
`$ apache2ctl configtest`
Restart Apache to finalize the configuration change by using the following command:
`$ apache2ctl restart`
Vhost configuration example
In this example, you create sites for three customers, one of which is a completely different mobile site.
You configure the vhosts for all three customers by using the following command sequence:
$ cd /etc/apache2/sites-available $ sed -e 's/example.com/site1.com/' default.template > site1.com.conf $ sed -e 's/example.com/site2.com/' default.template > site2.com.conf $ sed -e 's/example.com/site3.com/' default.template > site3.com.conf $ sed -e 's/example.com/mobile.site3.com/' default.template > mobile.site3.com.conf $ a2ensite site1.com.confsite2.com.confsite3.com.confmobile.site3.com.conf $ mkdir -p /var/www/vhosts/site1.com /var/www/vhosts/site2.com /var/www/vhosts/site3.com /var/www/vhosts/mobile.site3.com $ apache2ctl configtest $ apache2ctl restart /var/www/ ├── html │ └── index.html └── vhosts ├── mobile.site3.com ├── site1.com ├── site2.com ├── site3.com
Each directory below the vhosts directory is a document root for the listed site. A document root is a directory that is stored on your host’s servers and that is designated for holding web pages. As HTTP requests come into the server, Apache determines which domain the request is for, then routes the request to the appropriate document root, as specified in the vhosts configuration file.
©2019 Rackspace US, Inc.
Except where otherwise noted, content on this site is licensed under a Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License