Skip to content

Latest commit

 

History

History
84 lines (50 loc) · 1.72 KB

README.md

File metadata and controls

84 lines (50 loc) · 1.72 KB

Ginn

Ginn is not nginx.

What is Ginn?

Ginn is a web server inspired by nginx. It employs an event-driven approach to address C10k problems and achieves scaling by reloading configuration files without dropping client requests.

Note. This was created for educational purposes and is not suitable for real production.

Getting start

Please try it out with Docker first!

$ docker container run --rm -d -p 4700:80 whtsht/ginn

and open http://localhost:4700.

Installation

First, clone this repository and go to the directory.

Install Local

Build Ginn locally and place it in the appropriate directory.

$ make && sudo make install

Start Ginn with root permission.

$ sudo ginn start

and open http://localhost.

Ginn uses a well-known 80 port by default. If you don't like this behavior, edit /etc/ginn.conf.

- # port 4700;
+ port 4700;

Using Docker

Start Ginn using docker-compose.

$ docker compose up -d

and open http://localhost:4700.

Unit tests

This project uses CUnit Test Framework. Please install it.

Run all tests with the following command.

$ make test

Benchmarking

You can test and benchmark using siege.

Note. Start Ginn on port number 4700.

$ siege -c 200 -t 5S -b -i --log=/tmp/siege.log -f ./urls.txt

References