Ubuntu Hardy - Apache configuration #1

As we know, Ubuntu Hardy uses a different layout from other non-Debian based systems - let's move on and take a look at the main apache2.conf and ports.conf.

We're not actually going to change a lot at this point, just look at the main settings and see what they mean and what a change will actually do


Why no specific changes to the default?

Well, it's difficult to give a definitive configuration as there are so many variables to consider such as expected site traffic, Slice size, site type, etc.

Remember that it is very unlikely the default Apache configuration will be ideal for your Slice. Don't be intimidated by the thought of 'optimising' the install - following the next couple of articles will allow you to understand the meaning behind the concepts.

You'll also find the same things apply to any web server - they may call them different things, but the concepts remain the same.

My advice is very simple: experiment. Find what works best on your setup.


Let's start with the ports.conf file:

sudo nano /etc/apache2/ports.conf

The default entry is:

Listen 80

<IfModule mod_ssl.c>
    Listen 443

Well, that seems fair enough. Port 80 is the standard HTTP port to listen on and if you have the ssl module loaded, then it will also listen on port 443 (HTTPS)

Configuring Apache to listen on another port, say 8080, is as simple as adding:

Listen 8080

Once that is added to the file and Apache restarted, it would listen on port 8080.


now open up the main Hardy Apache config file:

sudo nano /etc/apache2/apache2.conf

I won't list the contents here but, if you are not familiar with the settings, have a read of the comments. I find them very informative and straight to the point.

You may be surprised how well config files are documented. I always recommend giving them a read - sure, they may not make a lot of sense to begin with but as time goes by you will be able to glance at them and know what to change.

Anyway, let's look at some of the main settings and what they mean:



Timeout 300

This sets (in simple terms) the maximum time, in seconds, to wait for a request, action it and the response to the request.

The default is deliberately set high to allow for varied situations. You can reduce this to something more sane, such as 45 or even lower. A decrease may also help in reducing the effects of a DOS attack.



KeepAlive On

Keep this set at 'On' as it allows for persistent connections to a client so each file, image, etc is not requested with a new connection. This allows for more efficiency. Define the KeepAlive settings as shown below:



MaxKeepAliveRequests 100

Now we have our persistent connection, set the maximum number of requests per connection. Keep this high more maximum efficiency. If you have a site with lots of images, javascripts, etc, try increasing this to 200.



KeepAliveTimeout 15

So how long does the persistent connection wait for the next request? The default setting is very high and can easily be reduced to 2 or 3 seconds. If no new requests are received during this time the connection is killed.

What does this mean? Well, once a connection has been established and the client has requested the files needed for the web page, this setting says "sit there and ignore everyone else until the time limit is reached or you get a new request from the client".

Why would you want a higher time? In cases where there will be a lot of interactivity on the site. However, in most cases, people will go to a page, read it for a while and then click for the next page. You don't want the connection sat there doing nothing and ignoring other users.

prefork MPM

During the Ubuntu Hardy Apache install we selected apache2-mpm-prefork and not apache2-mpm-worker. If you want to know more about the differences between the two I will point you towards the official Apache docs (which are actually very good).


<IfModule mpm_prefork_module>
    StartServers                  5
    MinSpareServers           5
    MaxSpareServers          10
    MaxClients                    150
    MaxRequestsPerChild   0

Again, it's difficult to give a suggestion here as to what is best for your site but have a read of the definitions below and see if anything could be improved when you consider what your site(s) serves.

StartServers: number of child server processes created at startup

MinSpareServers: minimum number of child server processes not doing anything (idle).

MaxSpareServers: maximum number of child server processes not doing anything (idle) - any more than the maximum will be killed.

Don't set Max lower than Min but Apache will ignore silly numbers here and set the Max at Min+1.

MaxClients: sets the maximum simultaneous requests that Apache will handle. Anything over this number will be queued until a process is free to action the request.

MaxClients is not the same as the maximum number of visitors you can have. It is the maximum requests.

Remember the KeepAliveTimeout? This was set low so the next request can be actioned and the original (now 'idle') client will still be sat there reading your webpage - the new (active) request will be actioned or, if the MaxClients limit has been reached, will be queued ready for the next available process.

In most cases, the client is not 'active'. Take this page. You requested it (using an active process) and then spent a while reading it which uses no processes - you are 'idle' (as far as the server is concerned!).

MaxRequestsPerChild: sets how many requests a child process will handle before terminating. The default is zero, which means it will never die.

Why change this if the Max numbers are set as shown above? Well, it can help in managing your Slice memory usage.

If you change the default you give a child a finite number of actions before it will die. This will, in effect, reduce the number of processes in use when the server is not busy. Thus freeing memory.

Freeing it for what though? If other software needed memory then it would also need it when the server is under load. It is unlikely you will have anything that requires memory only when the server is quiet.


Quite a lot here but as you go through the different settings you will see that the theory is quite simple. Naturally, there is a lot more to it than this article (or set of articles) can go into.

In the second apache2.conf article we will look at other settings that will add some more efficiency and help in increasing the security of our Slice.


Article Comments:

dynamethod commented Sun Jun 08 14:28:31 UTC 2008:

you rock dude, your site has all the exact information im looking for

Steve commented Wed Jul 02 02:07:15 UTC 2008:


Great article! You can use MPM MaxRequestsPerChild to combat potential memory leaks in PHP/Java code. Thus, when X requests have been completed, it can free the resource and dump it's memory. This helps during times of load and immediately after (specifically on resource intensive sites) as it reduces the overall amount of Ram being eaten by Apache.

Not saying that you shouldn't keep on top of sloppy coding - but it helps to reduce the likelihood that sloppy coding will result in a 3am callout!

Richard commented Sat Aug 16 21:57:27 UTC 2008:

I don't think KeepAliveTimeout really tells the webserver to ignore other connections. It just sets a limit on how long an idle connection will be kept open.

I wonder why the default for Hardy is 15 seconds, but the Apache docs say the default is 5 seconds. Maybe dial-up clients benefit from the longer wait.

himadri commented Wed Sep 24 22:19:12 UTC 2008:

such a lucid of explaining things ... way to go

santosh commented Mon Sep 29 16:26:27 UTC 2008:

As easy as 1-2-3....you guys rock

julien commented Mon Nov 03 19:32:34 UTC 2008:

What is the purpose to change the port from 80 to 8080?

Thanks for this tut.

PickledOnion commented Tue Nov 04 12:41:48 UTC 2008:


I don't mention changing the port in this article.

I am not sure what you mean. If it is a general enquiry then this is not really the place for it - please create a forum post.


julien commented Tue Nov 04 12:56:50 UTC 2008:

Sorry, i misunderstood the part where you tell how to change the Listen configuration in ports.conf. I'm a complete n00b so un thought you suggested to actually change this from 80 to 8080.

Want to comment?

(not made public)


(use plain text or Markdown syntax)