Introduction¶

What is flere¶

flere is a http server (webserver) written in pure lua. This project was started on a lazy sunday afternoon
in march 2010.

Why yet another http server? Are there not enough of those?¶

flere was written to see if it works ;) , no other reasons really.

What can it do?¶

flere can serve HTML pages, images, videos (the usual stuff), also it has (very basic) support
to serve lua scripts as weird kind of module.

And, does it work?¶

sort of, its still under development ...

What do i need to run it?¶

you will need the following lua packages:

lua 5.1 itself (obviously), lua-socket, copas

How can i test it?¶

to test flere follow these steps:

1) get the snapshop here:

http://projects.plentyfact.org/projects/list_files/flere

2) unpack the tar.gz file

tar xzzvf flere-0.1-snapshot.tar.gz

3) enter the directory

cd flere-0.1-snapshot

a) edit the config file (flere.conf) according to your needs,
especially the "root_dir" and "port" parameters.

b) in the file "flere" , adjust the line

dofile '/etc/flere/flere.conf'

by pointing to your config file.

5) start flere:

./flere

I'm running Debian / Ubuntu¶

Lucky you! There are debian packages in

http://projects.plentyfact.org/projects/list_files/flere

Latest Version¶

the latest version is 0.1.9 (30 april 2010)

features:
- serves static html and most media files (the usual suspects such as images and videos)
- basic support for apache style server side includes (currently only #include)
- lua files with GET variable support

configuration¶

configuration
features
enviromentalVariables

Is there some kind of roadmap?¶

well ...

aims for version 0.2:
- cleaner code (it's very nasty so far)

aims for version 0.3:
- improved support for server side includes
- some optimizations
- multiple domain support (aka virtual hosts) with decent host files

aims for version 0.5:
- support for ipv6 (maybe)

OMG, why do you want to implenet something like server side includes?¶

for some very simple static html pages, ssi are actually nice to have.

Hey, this or that does not work.¶

flere is in a very early stage, just hang on, it will be improved soon.

if you are looking for a full-featured webserver written in lua, try
Xavante ( http://keplerproject.github.com/xavante/ )

Is flere free software¶

Sure, flere is released under the GNU General Public License version 3.

flere

Wiki