Lighttpd Client Side Optimization With mod_expire To Control / Set The Expire HTTP Headers

in Categories lighttpd, Linux, Tips, Tuning, UNIX last updated April 17, 2007

The last time I wrote about Lighttpd optimization tips here and here.

You must optimize server side as well as client side. Client side optimization includes CSS code, javascript and images as they would hardly change.

You can force client web browser not to download files for particular day / hour.

Lighttpd comes with mod_expire module. It controls the Expire header in the Response Header of HTTP/1.0 messages. It is useful to set it for static files which should be cached aggressively like images, stylesheets, java scripts, pdf files or similar.

Step # 1: Make sure mod_expire is active

Open lighttpd config file /etc/lighttpd/lighttpd.conf, using a text editor such as vi:
# vi /etc/lighttpd/lighttpd.conf
You must load mod_expire before all other module to avoid ill side effects.

server.modules              = (
                               "mod_accesslog" )

Step # 2: Set expiration for /js/ and other dirs

Assigns a expiration to all files below the specified path:

## js - java script, css, figs directory in days ###
  expire.url = (
                  "/js/"     => "access 1 days",
                  "/css/"    => "access 3 days",
                  "/figs/" => "access 7 days"

You can also add conditional tags as follows:

$HTTP["url"] =~ "^/assets/figs/" {
     expire.url = ( "" => "access 12 hours" )

Save and close the file. Restart the lighttpd server using the following command:
# /etc/init.d/lighttpd restart

Step #3: Test your settings

Use the curl command as follows to test http headers:
$ curl -I your-url-here
$ curl -I http:

Posted by: Vivek Gite

The author is the creator of nixCraft and a seasoned sysadmin and a trainer for the Linux operating system/Unix shell scripting. He has worked with global clients and in various industries, including IT, education, defense and space research, and the nonprofit sector. Follow him on Twitter, Facebook, Google+.

Share this on (or read 2 comments/add one below):

2 comment

    Have a question? Post it on our forum!