mirror of
https://github.com/jwinterm/modoboa.git
synced 2026-10-18 05:51:26 +02:00
153 lines
3.8 KiB
ReStructuredText
153 lines
3.8 KiB
ReStructuredText
.. _webservers:
|
|
|
|
###########
|
|
Web servers
|
|
###########
|
|
|
|
.. _apache2:
|
|
|
|
*******
|
|
Apache2
|
|
*******
|
|
|
|
mod_wgsi
|
|
========
|
|
|
|
First, make sure that *mod_wsgi* is installed on your server.
|
|
|
|
Create a new virtualhost in your Apache configuration and put the
|
|
following content inside::
|
|
|
|
<VirtualHost *:80>
|
|
ServerName <your value>
|
|
DocumentRoot <path to your site's dir>
|
|
|
|
Alias /media/ <path to your site's dir>/media/
|
|
<Directory <path to your site's dir>/media>
|
|
Order deny,allow
|
|
Allow from all
|
|
</Directory>
|
|
|
|
Alias /sitestatic/ <path to your site's dir>/sitestatic/
|
|
<Directory <path to your site's dir>/sitestatic>
|
|
Order deny,allow
|
|
Allow from all
|
|
</Directory>
|
|
|
|
WSGIScriptAlias / <path to your site's dir>/wsgi.py
|
|
</VirtualHost>
|
|
|
|
This is just one possible configuration.
|
|
|
|
.. note::
|
|
*Django* 1.3 users, please consult this `page <https://docs.djangoproject.com/en/1.3/howto/deployment/modwsgi/>`_,
|
|
it contains an example *wsgi.py* file.
|
|
|
|
.. note::
|
|
You will certainly need more configuration in order to launch
|
|
Apache.
|
|
|
|
mod_python
|
|
==========
|
|
|
|
First, make sure that *mod_python* is installed on your server.
|
|
|
|
Create a new virtualhost in your Apache configuration and put the
|
|
following content inside::
|
|
|
|
<VirtualHost *:80>
|
|
ServerName <your value>
|
|
DocumentRoot <path to your site's dir>
|
|
|
|
<Location "/">
|
|
SetHandler mod_python
|
|
PythonHandler django.core.handlers.modpython
|
|
PythonPath "['<path to directory that contains your site's dir>'] + sys.path"
|
|
SetEnv DJANGO_SETTINGS_MODULE <your site's name>.settings
|
|
</Location>
|
|
|
|
Alias "/sitestatic" "<path to your site's dir>/sitestatic"
|
|
<Location "/sitestatic/">
|
|
SetHandler None
|
|
</Location>
|
|
|
|
Alias "/media" "<path to your site's dir>/media"
|
|
<Location "/media/">
|
|
SetHandler None
|
|
</Location>
|
|
</VirtualHost>
|
|
|
|
This is just one possible configuration.
|
|
|
|
.. note::
|
|
You will certainly need more configuration in order to launch
|
|
Apache.
|
|
|
|
.. _nginx-label:
|
|
|
|
*****
|
|
Nginx
|
|
*****
|
|
|
|
`Nginx <http://nginx.org/>`_ is a really fast HTTP server. Associated
|
|
with `Green Unicorn <http://gunicorn.org/>`_, it gives you one of the
|
|
best setup to serve python/Django applications. Modoboa's
|
|
performances are really good with this configuration.
|
|
|
|
To use this setup, first download and install those softwares
|
|
(`Install gunicorn <http://gunicorn.org/install.html>`_ and `install
|
|
nginx <http://wiki.nginx.org/Install>`_).
|
|
|
|
Then, use the following sample *gunicorn* configuration (create a new
|
|
file named *gunicorn.conf.py* inside Modoboa's root dir)::
|
|
|
|
backlog = 2048
|
|
bind = "unix:/var/run/gunicorn/modoboa.sock"
|
|
pidfile = "/var/run/gunicorn/modoboa.pid"
|
|
daemon = True
|
|
debug = False
|
|
workers = 2
|
|
logfile = "/var/log/gunicorn/modoboa.log"
|
|
loglevel = "info"
|
|
|
|
To start gunicorn, execute the following commands::
|
|
|
|
$ cd <modoboa dir>
|
|
$ gunicorn_django -c gunicorn.conf.py
|
|
|
|
Now the *nginx* part. Just create a new virtual host and use the
|
|
following configuration::
|
|
|
|
upstream modoboa {
|
|
server unix:/var/run/gunicorn/modoboa.sock fail_timeout=0;
|
|
}
|
|
|
|
server {
|
|
listen 443;
|
|
server_name <host fqdn>;
|
|
root <modoboa's root dir>;
|
|
|
|
access_log /var/log/nginx/<host fqdn>.access.log;
|
|
error_log /var/log/nginx/<host fqdn>.error.log;
|
|
|
|
location /sitestatic/ {
|
|
autoindex on;
|
|
}
|
|
|
|
location /media/ {
|
|
autoindex on;
|
|
}
|
|
|
|
location / {
|
|
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
|
proxy_set_header Host $http_host;
|
|
proxy_redirect off;
|
|
proxy_set_header X-Forwarded-Protocol ssl;
|
|
proxy_pass http://modoboa;
|
|
}
|
|
}
|
|
|
|
Paste this content to your configuration (replace values between
|
|
``<>`` with yours), restart *nginx* and enjoy a really fast
|
|
application!
|