2,14 → 2,65 |
----------------- |
|
The Debian version of Prayer is built with SSL support with session |
cache using libdb4.3, gzip Content-Transfer-Encoding, LDAP, and System |
cache using libdb4.6, gzip Content-Transfer-Encoding, LDAP, and System |
V mutex support. The previous version, which was only uloaded to the |
experimental distribution, was heavily patched to add UTF-8 and IPv6 |
support among other things. All that has been incorporated and |
improved by upstream in 1.1.0. The remaining patches concern changes |
to default configuration regarding directory structure, and minor |
cosmetic changes to the folder list. |
to the default configuration as detailed below, or fix bugs. You can |
always find information about patches in changelog.Debian.gz. |
|
To enable Prayer, you must edit /etc/default/prayer and change |
ENABLED=0 to ENABLED=1. But before you do that you should go through |
/etc/prayer/prayer.cf and adapt it to your needs. In particular, if |
you already run a web server on this machine you need to change |
use_http_port (and use_https_port) to something else. |
|
Debian-specific configuration defaults: |
|
* Static files (templates, icons, CSS files) are installed in |
/usr/share/prayer in accordance with policy. The prefix option |
points there, while var_prefix, the location of pid files |
(pid_dir), sockets (socket_dir), and the SSL session cache |
(ssl_session_dir), is /var/run/prayer and subdirectories. Log |
files are written to /var/log/prayer (log_dir) and /tmp is used to |
temporarily store uploaded attachments (tmp_dir). |
|
* Prayer by default runs as user prayer (created on install) and |
group nogroup. The prayer user is added to the ssl-cert group on |
installation, so that it can access keys in /etc/ssl/private. |
|
* ssl_cert_file and ssl_privatekey_file point to the "snake oil" |
certificate and key created by the ssl-cert package, so that you |
only have to uncomment use_https_port to enable encryption. For a |
production server you should of course install a real certificate. |
|
* Support for SSL session caching is compiled in, but caching is |
disabled by default, as it probably doesn't make that much a |
difference on modern hardware. To enable it, uncomment the |
ssl_session_timeout setting in prayer.cf. You should also arrange |
for prayer-ssl-prune and prayer-db-prune to be run periodically, |
for example by placing symlinks to them in /etc/cron.hourly or |
/etc/cron.daily. |
|
* The default IMAP folders for sent mail (sent_mail_folder) and |
drafts (postponed_folder) are "Sent" and "Drafts", respectively, |
the default for Mozilla Thunderbird and others (although many IMAP |
clients unfortunately use localized folder names). |
|
* socket_split_dir is off by default to reduce complexity when |
testing. You will probably only need it if you have lots of |
simultaneous users and a file system without directory indexes. |
|
Customizing templates: |
|
To use customized templates you must set template_use_compiled to |
FALSE in prayer.cf. Then copy the template (.t file) you wish to |
customize from /usr/share/prayer/templates to the corresponding |
location under /etc/prayer/templates and edit it there. Prayer will |
still use the compiled-in versions of the remaining templates, thanks |
to a small patch. |
|
Quirks: |
|
* If your IMAP server supports STARTTLS, then Prayer (actually the |
27,5 → 78,27 |
containing a dot. Unfortunately this means that the preference |
folder will be fully visible. |
|
-- Magnus Holmgren <holmgren@debian.org>, Tue, 13 May 2008 22:27:11 +0200 |
* Prayer doesn't handle signals gracefully yet, which means that it |
will leave SysV semaphores lying around when it is stopped or |
restarted. You can use ipcs to find them and ipcrm to delete them. |
|
* While Prayer does its best to remove potentially harmful tags from |
HTML email, it doesn't try to convert it to XHTML. This means that |
Prayer's output is conformant XHTML only when not viewing HTML |
mail. |
|
* Prayer deletes mail the IMAP way, which is by marking messages as |
deleted and leaving them in their folders. Prayer always lists |
deleted messages (with a special icon) and expunges (deletes |
permanently) deleted messages only when explicitly requested. |
Before that they can be undeleted at any time by "unmarking" them. |
|
Most mail client software deletes mail by moving it to a "trash" |
folder, which in reality means creating a copy in the trash folder |
and marking the original deleted. Messages that are marked as |
deleted are usually never listed, cannot be unmarked, and are often |
automatically expunged. These two approaches are rather |
incompatible, but some software can take either. |
|
-- Magnus Holmgren <holmgren@debian.org>, Mon, 23 Jun 2008 20:57:05 +0200 |
|