Howto: Lighttpd web server setting up virtual hosting

by on July 6, 2006 · 27 comments· LAST UPDATED October 9, 2006

in , ,

Lighttpd logo

Last time I wrote about setting and installing lighttpd web server.

Virtual hosting allows sharing a lighttpd web server so that you can have multiple domains hosted on single web server. For example:
=> etc

Our setup

Lighttpd supports both Name-based and IP-based virtual hosts. Let us see how to configure two web sites for:

First create a directory for each domain:

# mkdir -p /home/lighttpd/
# mkdir -p /home/lighttpd/
# chown lighttpd:ftpuser1 /home/lighttpd/
# chown lighttpd:ftpuser2 /home/lighttpd/

Replace ftpuser1 and 2 with actual ftp username.

Also create a log directory for each domain:
# mkdir /var/log/lighttpd/
# mkdir /var/log/lighttpd/

Only allow a web server to access our logs:
# chown -R lighttpd:lighttpd /var/log/lighttpd

Open lighttpd configuration file:
# vi /etc/lighttpd/lighttpd.conf

Add support for domain
$HTTP["host"] =~ "(^|\.)nixcraft\.com$" {
server.document-root = "/home/lighttpd/"
server.errorlog = "/var/log/lighttpd/nixcraft/error.log"
accesslog.filename = "/var/log/lighttpd/nixcraft/access.log"
server.error-handler-404 = "/e404.php"

Add support for domain
$HTTP["host"] =~ "(^|\.)theos\.in$" {
server.document-root = "/home/lighttpd/"
server.errorlog = "/var/log/lighttpd/"
accesslog.filename = "/var/log/lighttpd/"
server.error-handler-404 = "/e404.php"


  • $HTTP["host"] =~ "(^|\.)theos\.in$" : It will match request for both and domain
  • server.document-root = "/home/lighttpd/" : Server document root. You must set ftp/ssh user home directory to this root only
  • server.errorlog = "/var/log/lighttpd/" : Server access log file
  • accesslog.filename = "/var/log/lighttpd/": Server error log file
  • server.error-handler-404 = "/e404.php" : Web server error 404 handler file

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

Upload file(s) to respective web-root and test your configuration with a web browser.

TwitterFacebookGoogle+PDF versionFound an error/typo on this page? Help us!

{ 27 comments… read them below or add one }

1 Calvin Chan May 15, 2007 at 6:56 am


I have been trying to setting up this virtual host for my server. However, I am running into this problem where the error log is not stored in the right directory. I have followed everything in your guide. The only difference is that instead of using host, I am using ip based address. It seems like the error will store in the the directory that list ed last first.

For example:

$SERVER[“socket”] == “a.b.c.d:80″ {
server.document-root = “/var/www/html/a.b.c.d/”
server.errorlog = “/var/log/lighttpd/a.b.c.d/error.log”

$SERVER[“socket”] == “″ {
server.document-root = “/var/www/html/”
server.errorlog = “/var/log/lighttpd/”

The error will store in directory. Do you know if there’s a solution to that? Any help would be greatly appreciated. Thanks in advance.



2 nixCraft May 15, 2007 at 12:49 pm

I’m sorry but I don’t get your problem. Can you explain more..???


3 rxKaffee May 23, 2007 at 7:53 pm

It seems that you can only define server.errorlog once in lighty configuration. ie. one errorlog for the whole server and all vhosts.


4 ligesh July 3, 2007 at 4:41 am

Yes. The server.errorlog doesn’t work on a per virtualhost basis. Is that a bug or by design?



5 kunal July 22, 2007 at 2:29 pm

Please check the permissions of your log files

is the user is root or lighttpd or the user u have created.

Must note that logfolder/files have lighttpd as owner not root


6 Jain July 23, 2007 at 10:15 am

Hi after all the settings done as aforesaid when i try to run my site in browser it give me an error while if i open my site trough IP of the server then it vl open

in server.bind i m using IP address and and i m trying to open my site
server.port = 90

when in browser i type it will open my default page

but if i type then gives me error problem loading page.

How to handle this error.
pls help me


7 Jain July 23, 2007 at 10:22 am

opening site in browser with port number


8 shiato han July 17, 2008 at 9:05 am

can lighttpd do this kind of virtual hosting (

linux newbie


9 Terry July 21, 2008 at 2:55 pm

Regular reader of articles. Just one thing I can’t get sorted out here. What I haven’t done yet that is preventing Lighttpd from running. Error: “can’t find name apache” A clue to sort this out would be great!


10 Roon October 27, 2008 at 12:59 pm

Thanks for this, I have migrated from apache to lighttpd on my VPS and it has meant that I don’t have to upgrade my VPS memory any more!

Saved me some money!


11 Dan Wincet January 10, 2009 at 5:04 am

Calvin Chan, rxKaffee, and ligesh are right, lighttpd only uses the server.errorlog which appears last in the config file, regardless of any conditionals.

i wish you would test your config to make sure it works before posting bogus “tutorials” like this.


12 dreams April 8, 2009 at 4:43 pm

I am all confused. I have installed lighttpd on my embedded linux box. If this box is connected to the pc via USB, I am able to access the webserver. But if I configure the server for some static ip, say a.b.c.d and try to access it by typing http://a.b.c.d:80, I do not get anything at all.

Do we have to do anything (some change in the .conf file). What is ipv6 and ipv4 all about?


13 Hitur Petur June 17, 2009 at 11:33 am

A quick note why might this exacmple not match.
$HTTP[“host”] =~ “(^|\.)nixcraft\.com$” {
A port number might be appended to the end…so..

$HTTP[“host”] =~ “(^|\.)nixcraft\.com(\:[0-9]*)?$”

Is probably a better guess. This worked for me. Cheers.


14 firmit June 21, 2009 at 6:47 am

I had to add my virtual hostname in /etc/hosts as well: localhost vhost1 # which is defined in /etc/lighttp/vhosts.conf


15 Anand September 19, 2009 at 8:15 am


I mention the ftp username, where is the pass?


16 Ela October 1, 2009 at 3:39 pm


Please can you find out why this error log is creating. its increasing day by day. Please tell me a solution to delete this file when it is more than 10 mb.

[Tue Sep 08 11:08:31 2009] [error] [client] File does not exist: /var/www/vhosts/louis
[Wed Sep 09 00:20:51 2009] [error] [client] File does not exist: /var/www/vhosts/louis
[Wed Sep 09 13:43:39 2009] [error] [client] File does not exist: /var/www/vhosts/louisvi
[Thu Sep 10 18:56:31 2009] [error] [client] File does not exist: /var/www/vhosts/louis
[Fri Sep 11 00:21:22 2009] [error] [client] File does not exist: /var/www/vhosts/louis
[Wed Sep 16 00:36:03 2009] [error] [client] File does not exist: /var/www/vhosts/louisvi
[Wed Sep 16 05:43:16 2009] [error] [client] File does not exist: /var/www/vhosts/louis
[Wed Sep 16 10:37:25 2009] [error] [client] File does not exist: /var/www/vhosts/louisv
[Wed Sep 16 10:37:26 2009] [error] [client] File does not exist: /var/www/vhosts/louisv
[Wed Sep 16 15:58:09 2009] [error] [client] File does not exist: /var/www/vhosts/louisv
[Thu Sep 17 03:06:00 2009] [error] [client] File does not exist: /var/www/vhosts/louisv
[Thu Sep 17 07:21:51 2009] [error] [client] File does not exist: /var/www/vhosts/louis
[Sat Sep 19 02:22:02 2009] [error] [client 76.73.3[Sat Sep 26 11:05:18 2009] [error] [client 66.249.
71.211] File does not exist: /var/www/vhosts/
[Sat Sep 26 20:40:23 2009] [error] [client] File does not exist: /var/www/vhosts/


17 Vamsi October 19, 2009 at 2:29 pm

Thanks..really helpful..
I was scratching my head to host multiple domains on my vps..



18 HB December 6, 2009 at 1:36 am

My newdomain-script lighttpd&mod_mysql_vhost&wordpress_permalink

echo "Enter new zone"
read zone
echo "Enter new domain"
read domain
echo "Your new domain is $domain.$zone"
if [ ! -d  /var/www/servers/$domain.$zone ];
mkdir /var/www/servers/$domain.$zone
mkdir /var/www/servers/$domain.$zone/www && chown www-data:www-data /var/www/servers/$domain.$zone/www
mkdir /var/www/servers/$domain.$zone/logs && chown www-data:www-data /var/www/servers/$domain.$zone/logs
mkdir /var/www/servers/$domain.$zone/cgi && chown www-data:www-data /var/www/servers/$domain.$zone/cgi
mkdir /var/www/servers/$domain.$zone/subdomain && chown www-data:www-data /var/www/servers/$domain.$zone/subdomain
echo '$HTTP["host"] =~ "(^|\.)'$domain'\.'$zone'$" {' > /etc/lighttpd/vhosts/50-$domain.$zone.conf
echo 'server.document-root = "/var/www/servers/'$domain'.'$zone'/www/"' >> /etc/lighttpd/vhosts/50-$domain.$zone.conf
echo 'accesslog.filename = "/var/www/servers/'$domain'.'$zone'/logs/access.log"' >> /etc/lighttpd/vhosts/50-$domain.$zone.conf
echo 'server.errorlog = "/var/www/servers/'$domain'.'$zone'/logs/error.log"' >> /etc/lighttpd/vhosts/50-$domain.$zone.conf
echo '#server.error-handler-404 = "/"' >> /etc/lighttpd/vhosts/50-$domain.$zone.conf
echo '# Wordpress Permalinks' >> /etc/lighttpd/vhosts/50-$domain.$zone.conf
echo 'include "wp-rewrite.conf"' >> /etc/lighttpd/vhosts/50-$domain.$zone.conf
echo '}' >> /etc/lighttpd/vhosts/50-$domain.$zone.conf
echo "[client]" > /home/user/.my.cnf
echo "port            = 3306" >> /home/user/.my.cnf
echo "socket          = /var/run/mysqld/mysqld.sock" >> /home/user/.my.cnf
echo "default-character-set=utf8" >> /home/user/.my.cnf
echo "user=inshttpd" >> /home/user/.my.cnf
echo "password=qwertyui" >> /home/user/.my.cnf
echo "insert into "'`domains`'" ("'`domain`'", "'`docroot`'") values ('$domain.$zone', '/var/www/servers/$domain.$zone/www');"\
> /tmp/$domain.$zone.sql
/usr/bin/mysql httpd  /dev/null

# Wordpress Permalinks
url.rewrite-once = (
  "^/(wp-.+).*/?" => "$0",
  "^/images/.*/?" => "$0",
  "^/temp/.*/?" => "$0",
  "^/(sitemap.xml)" => "$0",
  "^/(xmlrpc.php)" => "$0",
  "^/keyword/([A-Za-z_0-9\-]+)/?$" => "/index.php?keyword=$1",
  "^/.*?(\?.*)?$" => "/index.php$1"


19 salem November 13, 2014 at 4:51 am

Tanks for script I’ll checkout if it’s works .


20 DanielS January 13, 2010 at 7:37 am

I just wanted to say thanks, this post helped me get all of my virtual host’s back up and running in no time! I had been using ispconfig3 prior and decided why have extra bloat when I can do it myself with just a little work, and this proved to be much better then what I had before! It’s noticably faster and I can’t thank you enough!

Also I noticed that user lighttpd wasn’t created however www-data worked fine, is this a problem to be using this user:group instead of lighttpd:lighttpd security wise or other?

Thanks again!


21 Deo January 7, 2011 at 3:17 am

thanks for the inputs. this works for me.


$SERVER[“socket”] == “:8081″ {
server.document-root = “/var/www/app_name/”
server.errorlog = “/var/log/lighttpd/app_name/error.log”


22 ankit March 29, 2011 at 11:44 am

I am facing the problem in linking the cgi script to the HTML page . whenever i try to open it in the web browser a 404 error appears.
cgi.assign = ( “.cgi” => “http://ip-address/mnt/apps/web/cgi-bin/” )

$SERVER[“socket”] == “:80″ {
My cgi bin has a .cgi file in it.


23 satimis April 14, 2011 at 1:51 pm


# chown lighttpd:ftpuser1 /home/lighttpd/
# chown lighttpd:ftpuser2 /home/lighttpd/

Please shed me some light on the groups “ftpuser1″ and “ftpuser2″. What they are? Thanks.

Neither I have user “lighttpd”. Whether run “addusr” to add it?



24 Marc August 18, 2011 at 11:11 am

In the first step you create a directory for logs:

# mkdir /var/log/lighttpd/

but later you create a file server.errorlog = “/var/log/lighttpd/nixcraft/error.log”

Did you mean server.errorlog = “/var/log/lighttpd/ ?


25 Nassou September 7, 2011 at 2:10 am

Is probably the biggest handicap for lighttpd, guys it’s not possible to set error log for each vhost like apache,nginx etc.

So this conditionnal will not work :

$HTTP[“host”] =~ “(^|\.)nixcraft\.com$” {
>>>> server.errorlog = “/var/log/lighttpd/nixcraft/error.log”

You have one lighttpd running, so one error.log, so says one of the developers of lighty

The only method is to track the errors by hand on the script or other, example :

I will repeat what was said above, lighttpd is designed like that, let’s wait for a patch or other, who knows ?



26 vijay March 28, 2012 at 9:48 am

Hi all.. i have configured as wat u said but still i get error “server not found”
i have added following line in my lighttpd.conf
$HTTP[“host”] =~ “(^|\.)domainname\.in$” {
server.document-root = “/home/lighttpd/”
server.errorlog = “/var/log/lighttpd/error.log”
accesslog.filename = “/var/log/lighttpd/access.log”
I have upload my webfiles under /
after that i restarted lighttpd.i opened browser and type
but it shows server not found.


27 ali March 3, 2015 at 7:12 am

can any body tell me how virtual hosting enable in lighttpd in centos 6.5..
i want to host multiple web site form my server ,,,it may be name based or ip based what ever you have material regarding ….i have done all those step which you have pasted above ….


Leave a Comment

Previous post:

Next post: