diff --git a/pages/home.rst b/pages/home.rst index 287e8570..bd069719 100644 --- a/pages/home.rst +++ b/pages/home.rst @@ -24,6 +24,8 @@ Radicale runs on most of the UNIX-like platforms (Linux, \*BSD, MacOSĀ X) and Windows. It is free and open-source software, written in Python, released under GPL version 3. +.. log:: + Main Features ============= diff --git a/pages/user_documentation.rst b/pages/user_documentation.rst index 5221d095..7cdfaea1 100644 --- a/pages/user_documentation.rst +++ b/pages/user_documentation.rst @@ -340,44 +340,54 @@ options. These options are available by typing:: radicale --help -Use Radicale with Apache2 and mod_wsgi --------------------------------------- +WSGI, CGI and FastCGI +--------------------- -For using Radicale with Apache's ``mod_wsgi``, you first have to write -your ``.wsgi`` file (in ``/var/www`` for example): +Radicale comes with a `WSGI `_ support, allowing the software +to be used behind any HTTP server supporting WSGI such as Apache. + +Moreover, it is possible to use `flup +`_ to wrap Radicale into a CGI, +FastCGI, SCGI or AJP application, and therefore use it with Lighttpd, Nginx or +even Tomcat. + +Apache and mod_wsgi +~~~~~~~~~~~~~~~~~~~ + +To use Radicale with Apache's ``mod_wsgi``, you first have to write your +``.wsgi`` file (in ``/var/www`` for example): .. code-block:: python - import radicale - application = radicale.Application() + import radicale + application = radicale.Application() .. note:: - We assume that Radicale is installed in your Python path. + We assume that the Radicale module is installed in your Python path. -Next you have to create the apache virtual host (adapt the configuration +Next you have to create the Apache virtual host (adapt the configuration to your environment): .. code-block:: apache - - ServerName cal.yourdomaine.org + + ServerName cal.yourdomain.org - WSGIDaemonProcess radicale user=www-data group=www-data threads=1 - WSGIScriptAlias / /var/www/radicale.wsgi + WSGIDaemonProcess radicale user=www-data group=www-data threads=1 + WSGIScriptAlias / /var/www/radicale.wsgi - - WSGIProcessGroup radicale - WSGIApplicationGroup %{GLOBAL} - AllowOverride None - Order allow,deny - allow from all - - + + WSGIProcessGroup radicale + WSGIApplicationGroup %{GLOBAL} + AllowOverride None + Order allow,deny + allow from all + + .. note:: - You should use the root of the (sub)domain (``WSGIScriptAlias /``), else - some CalDAV features will not work. - + You should use the root of the (sub)domain (``WSGIScriptAlias /``), else + some CalDAV features will not work. Authentication and URLs