1.1. Installation as a standalone application

The easiest and most efficient way to use Karrigell is to run it as a standalone application. The requests are handled by a built-in web server, which comes in many flavours :

  • Karrigell.py : multi-threaded
  • Karrigell_multiprocess.py : multi-process
  • Karrigell_async.py : asynchronous, using non-blocking sockets
  • Karrigell_monoprocess.py : mono-process, using blocking sockets

The 2 first ones should be used preferably in most situations ; they provide excellent response times, enough for the vast majority of web sites

The latter have lower performance (though still good enough in most cases) and should only be used in cases where session management should be done in memory

1.1.1 Standard installation

If Python (version 2.3 or above) is not already installed on your machine, you need to install it first : go to the Python language website and follow the installation instructions for your operating system

Then download the Karrigell archive (.tar.gz) and uncompress it in a directory such as

To launch the program, open a console window, go to this directory and run 

 (server dir)>Karrigell-3.1.1>python Karrigell.py
You should read the message :

 Karrigell 3.1.1 running on port 80
 Press Ctrl+C to stop

Type in http://localhost in the address field of your browser : you will see the default home page provided in the distribution

You can start the server on another port by changing the value of port in the configuration script server_config.py, in the same directory as Karrigell.py

1.1.2 Windows installer

For Windows users, the most simple way to install Karrigell is to download and execute the Windows installer. It includes a Python interpreter, so that you can run Karrigell even on a machine where Python was not installed

After installing, double-click on Karrigell.exe, this will start the built-in server with the same message as above