Debian-specific CiderWebmail usage notes
========================================


Supports integration with any PSGI frontend
-------------------------------------------

CiderWebmail uses PSGI, and can therefore be served either standalone
using e.g. twiggy or starman, or by a general purpose server like Apache
or nginx using with a binding like mod_perl, FCGI or uWSGI.

Simplest use is the following, invoked as the user www-data:

  plackup /etc/ciderwebmail/ciderwebmail.psgi

Included are snippets for production use integrating with Apache2 via
uWSGI, enabled like this as root:

  apt install apache2 libapache2-mod-uwsgi uwsgi uwsgi-plugin-psgi
  ln -s -t /etc/uwsgi/apps-enabled ../apps-available/ciderwebmail.ini
  a2enmod proxy_uwsgi
  a2enconf ciderwebmail
  service uwsgi restart ciderwebmail
  service apache2 restart

## Limit memory consumption

uWSGI optionally supports merging identical memory pages
for systems with more CPU cycles than memory to spare.

Uncomment ksm line in /etc/uwsgi/apps-available/ciderwebmail.ini
and enable ksm in the kernel:

	apt install sysfsutils
	echo "kernel/mm/ksm/run = 1" >> /etc/sysfs.d/local-ksm.conf


 -- Jonas Smedegaard <dr@jones.dk>  Sun, 02 Mar 2025 15:09:14 +0100
