Apache

The Apache HTTP Server is an efficient and extensible web server and one of the most popular ones used the Internet.

Support in other packages
There is a global USE flag apache2 which enables support for Apache in other packages. This may cause to be pulled in automatically if such packages are used.

After setting this you want to update your system so the changes take effect:

OpenRC
Start the Apache server:

Add Apache to the default runlevel:

Restart the Apache service:

Reload Apache configuration files:

systemd
Start the Apache server:

Add Apache to the default runlevel:

Restart the Apache service:

Testing
Verifying IP interfaces and ports on which apache2 is running on and listening to:

Testing if a connection to a Apache server is working on localhost:

Interrupt the connection test with + and.

Configuration files
There are 2 main files that configure Apache2's behavior on the system:


 * Gentoo's apache2 init script configuration file


 * Apache server's conventional configuration file

Gentoo's init script configuration file
The only active line in this file is as follow :

This line defines options that will be interpreted by the various configuration files using the   statement to activate or deactivate some part of the whole configuration. We will come back to this where appropriate in the rest of this guide.

Apache server's conventional configuration file - httpd.conf
In fact this file is only an entry point as the whole configuration is split in many files in the directory, that are assembled  together using the   directive. For example, the statement, in , aims at including all the files in  which name ends with.

Taking into account what has been said in the subsection above, and as module configuration files (files in /etc/apache2/modules.d) almost always start with the, the content of one file inside , will ONLY be assembled with the rest of the configuration, if the matching option is set using a   flag in the APACHE2_OPTS variable in the  file. The configuration file is an exception to this rule as it doesn't start with an   statement and therefore is always included in the resulting configuration.

Default configuration
After a fresh install of apache server, the configuration resulting from the assemblage of the different configuration files is as follows. We start with the entry point.

First sign of life
As you can see in the initial configuration above, the pre-installed virtual host's    directory is, its server name is localhost. In addition an index.html file is provided in the  directory, thus to check whether everything is correctly installed or not, point your browser to http://www.localhost.

You should see an "It works !" message on the page.

Enabling Security Module
Control this module by editing and  and restarting apache.

Enabling PHP support
Install PHP with the apache2 USE flag and enable the module:

To test if the PHP module works, create a test page:

Now open the test page: http://localhost/. You should see a table describing the PHP settings

Adding your own virtual hosts
For each virtual host, provide a  directory that is outside of the default document root, add a  file in the  directory and don't forget to add an entry for your domain name in.

To give apache read write permissions over vhosts:

example vhosts.  ServerAdmin email@site.com DocumentRoot /var/www/website1 ServerName domainname1.com 

 ServerAdmin email@site.com DocumentRoot /var/www/website2 ServerName domainname2.com 

replace xxxs with your ip address

An ip address entry is a good idea so when people ping any vhost they can go to this ip address in their browser, and you can post a denial message here, or links to all of your sites on your data network.

Troubleshooting

 * Troubleshooting guide

Common Issues
When starting apache, you might get the following error:

apache2: apr_sockaddr_info_get failed for SomeHostname

When this occurs, add your host name to the file.

External resources

 * Slicehost article: Installing Apache on Gentoo
 * Slicehost article: Apache configuration files on Gentoo
 * Slicehost article: Configuring the Apache MPM on Gentoo
 * Slicehost article: Apache configuration on Gentoo
 * Slicehost article: Apache Virtual Hosts on Gentoo
 * Slicehost article: Enabling and using apache's mod_status on Gentoo
 * apache.org documentation
 * Apache2 mod_pagespeed