Apache2 : Virtual Hosts

21 Aug 2015 #apache

What do we need?

The two most common tools for this are the Apache and nginx servers.

Notes:

You’ll need to edit a few system configuration files. If you’re uncomfortable with vim, replace vim with nano, or gedit in the following commands. For example, sudo vim will become sudo -H gedit or sudo nano.

Once you’re done setting it up, have a look at How to avoid using sudo when working in /var/www? A more detailed guide is available from the Ubuntu LTS Server Guide.

First, install Apache:

tasdik@Acer:~$ sudo apt-get install apache2

The Apache configuration files are located in /etc/apache2. You’ll typically be interested in:

/etc/apache2/sites-available - contains the Virtual Host definitions. Definitions are enabled and disabled using the a2ensite and a2dissitecommands. The enabled site definitions are linked to /etc/apache2/sites-enabled.
/etc/apache2/conf-available - contains custom configuration files. They are enabled and disabled using the a2enconf and a2disconf commands. The enabled site configuration files are linked to /etc/apache2/conf-enabled.
/var/www/html - the default directory that Apache serves.
For most instructions, I’ll assume we are in /etc/apache2.

VirtualHost setup

Let us create a new site. There’s a default configuration available in sites-enabled/default.conf. We will make a copy of this, and work on it:

This is where should be

tasdik@Acer:/etc/apache2$ ls
apache2.conf  conf-available  conf-enabled  envvars  magic  mods-available  mods-enabled  ports.conf  sites-available  sites-enabled
tasdik@Acer:/etc/apache2$

tasdik@Acer:~$ sudo cp sites-available/000-default.conf sites-available/my-name.conf
tasdik@Acer:~$ sudo nano sites-available/my-name.conf

It should look something like this


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

<VirtualHost *:80>
	# The ServerName directive sets the request scheme, hostname and port that
	# the server uses to identify itself. This is used when creating
	# redirection URLs. In the context of virtual hosts, the ServerName
	# specifies what hostname must appear in the request's Host: header to
	# match this virtual host. For the default virtual host (this file) this
	# value is not decisive as it is used as a last resort host regardless.
	# However, you must set it for any further virtual host explicitly.
	ServerName myname.com

	ServerAdmin webmaster@localhost
	DocumentRoot /var/www/my-name

	# Available loglevels: trace8, ..., trace1, debug, info, notice, warn,
	# error, crit, alert, emerg.
	# It is also possible to configure the loglevel for particular
	# modules, e.g.
	#LogLevel info ssl:warn

	ErrorLog ${APACHE_LOG_DIR}/error.log
	CustomLog ${APACHE_LOG_DIR}/access.log combined

	# For most configuration files from conf-available/, which are
	# enabled or disabled at a global level, it is possible to
	# include a line for only one particular virtual host. For example the
	# following line enables the CGI configuration for this host only
	# after it has been globally disabled with "a2disconf".
	#Include conf-available/serve-cgi-bin.conf
</VirtualHost>

# vim: syntax=apache ts=4 sw=4 sts=4 sr noet

Save the file, and enable it:

tasdik@Acer:~$ sudo a2ensite my-name

Now, we need to set up the directory for the site:

tasdik@Acer:~$ sudo mkdir /var/www/my-name

We’ll set permissions for convenience:

tasdik@Acer:~$ sudo chown $USER:www-data /var/www/my-name
tasdik@Acer:~$ sudo chmod g+s /var/www/my-name

Add a few HTML files here.

Since the virtual host is to run locally, we need to map myname.com to a local address. To do this, we need to edit /etc/hosts:

tasdik@Acer:~$ sudo nano /etc/hosts