You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
isso/docs/uWSGI.md

56 lines
1.2 KiB

uWSGI
=====
In short: [uWSGI](http://uwsgi-docs.readthedocs.org/) is awesome. Isso has
builtin support for it (and simple fallback if uWSGI is not available). Use
uWSGI if you think that the builtin WSGI server is a bad choice or slow (hint:
it's both).
With uWSGI, you have roughly 100% performance improvements for just using it.
Instead of one thread per request, you can use multiple processes, hence it
is more "web scale". Other side effects: spooling, fast inter-process caching.
Installation
------------
You need uWSGI 1.9 or higher, fortunately you can install it with Python:
```sh
~> apt-get install build-essential python-dev
~> pip install uwsgi
```
Configuration
-------------
For convenience, I recommend a INI-style configuration (you can also supply everything
as command-line arguments):
```ini
[uwsgi]
http = :8080
master = true
processes = 4
cache2 = name=hash,items=1024,blocksize=32
spooler = %d/mail
module = isso
virtualenv = %d
env = ISSO_SETTINGS=%d/sample.cfg
```
You shoud adjust `processes` to your CPU count. Then, save this file to a directory
if choice. Next to this file, create an empty directory called `mail`:
```sh
~> mkdir mail/
~> ls
uwsgi.ini mail/
```
Now start Isso:
```sh
~> uwsgi /path/to/uwsgi.ini
```