PRAYER.CF(5)

📦 version 1.3.5-dfsg1, in ubuntu jammy

okay bestie, welcome to prayer.cf(5) — that's the manual page for the main Prayer config file, filed under LOCAL. She's long, she's detailed, and she's about to be your whole personality. Let's go. 💅✨

👑 NAME 👑

prayer.cf — main Prayer configuration file

That's it. Short name, huge impact. She ate. 💖

🌸 DESCRIPTION 🌸

prayer.cf is the configuration file of prayer(8) and prayer-session(8).

Like, that's the whole vibe. Both of those programs read this file. She's the main character and they're the supporting cast. 🎀

🦋 SYNTAX 🦋

okay so for the most part, prayer.cf is just option = value pairs. Simple. Clean. But some config items are more complex, because of course they are. 🙈

All values may be enclosed in double quotes, which are stripped. Quotes must be used if a value contains a # character. Otherwise, everything following it is treated as a comment. Yes, everything. So if you forget those quotes, your carefully-typed value becomes a little gossip comment and vanishes. 💀

Any line can be folded using a \ character at the end of the line; any linear white space at the beginning of the next line is removed. So you can wrap long lines and it just works. Slay.

Simple options can be of the following types:

  • string — No particular restrictions. She's free. She contains multitudes. ✨
  • path — A file or directory name. The configuration parser expands occurences of a few macros in settings of this type. See prefix and var_prefix below. 🗂️
  • boolean — The following forms are interpreted as true: true, t, and 1. The following forms are interpreted as false: false, nil, 0. Capitalisation does not matter. So like, spell it however, she's not judging. 🫶
  • number — An integer number (sequence of digits 0-9), optionally immediately followed by a single letter K, causing the number to be multiplied by 1024, or M multiplying it by 1024 · 1024.
  • time — An integer number (sequence of digits 0-9) of seconds, optionally immediately followed by a single case-insignificant letter s, which has no effect, m, causing the number to be multiplied by 60, h, multiplying it by 60 · 60, or d, for a multiple of 24 · 60 · 60.
  • perm — A file permission mode; an octal number of exactly four digits, where the first digit must be 0. Four digits, first one's a zero, no negotiations. 🔒

✨ OPTIONS ✨

  • prefix (string), var_prefix (string) — The values of these options can be referred to as $prefix (or ${prefix}), and $var_prefix (or ${var_prefix}), respectively, in settings of type path in the rest of the file. Default: none. Need to be set only if referenced later. So like, if nobody's calling for her, she doesn't need to show up. 💅
  • prayer_user (string), prayer_uid (number) — User name or ID to setuid(2) to if started as root. Either, but not both, must be set and must not specify uid 0. Default: none.
fr fr, this one matters. Pick a name OR an ID, never both, and do not point her at uid 0. That's the whole point of dropping privileges, bestie. 😭
  • prayer_group (string), prayer_gid (number) — Group name or ID to setgid(2) to if we start off as root. In addition, prayer calls initgroups(3) if prayer_user is set. Default: none.
  • prayer_background (boolean) — Run prayer as background process. If true, prayer will return as soon as valid configuration is found. Default: true
  • file_perms (perm) — Create mode for new files. Default: 0640 if prayer_uid or prayer_user is set, otherwise 0644.
  • directory_perms (perm) — Create mode for new directories. Default: 0750 if prayer_uid or prayer_user is set, otherwise 0755.
  • check_directory_perms (boolean) — Check existing directories under ${var_prefix}?

📬 Mail server settings

  • imapd_server (string) — Specifies the default IMAP server(s) using libc-client syntax:
host[:port][/flag[/flag]...]

Multiple server specifications can be listed, separated by commas. Common flags are:

  • /ssl — Use SSL-on-connect (on port 993 by default).
  • /tls — Force use of TLS (using STARTTLS on the normal IMAP port) to encrypt the session. Recommended if the server is remote, since otherwise a downgrade attack is possible.
  • /notls — Don't issue STARTTLS even if the server supports it. Recommended if the server is localhost.
  • /novalidate-cert — Don't check the integrity of the server certificate.

For the full list of flags, see naming.txt.gz in the current libc-client package.

  • imapd_user_map (path) — CDB lookup map overriding default imapd_server location. For information on CDB, see
  • prefs_folder_name (string) — Name of Prayer user preferences folder on IMAP server.
  • use_namespace (boolean) — Use IMAP NAMESPACE command to find personal_hierarchy and hiersep. Default: true.
  • personal_hierarchy (string) — If not supplied by NAMESPACE. Default: "".
  • hiersep (string) — If not supplied by NAMESPACE. Default: "/".
  • dualuse (boolean) — Hint to Prayer that new mailboxes are dual use (i.e. can contain both mail and inferior mailboxes). Things will mostly work if dualuse set to false on a server which supports it, but people will be unable to create children of newly created mailboxes without refreshing the view.

Default: false.

  • sieved_server (string) — Talk to Cyrus timsieved using MANAGESIEVE protocol. Syntax is similar to imapd_server, except the only recognised flag is /ssl.
  • sieved_user_map (path) — Can be used to provide individualised imapd_server settings in the form of a CDB file.
  • sieved_timeout (time) — Default timsieved timeout is 10 minutes

🌐 Mail domain configuration

  • local_domain — Define a valid local domain, and optionally the valid local parts in that domain. This is a special directive that can appear multiple times and does not use an equals sign:
local_domain domain [map]

Without map, local_domain simply defines a domain which will appear on the list visible to user preferences. With map, it also defines a list a CDB map file which defines valid entries in that domain; used for personal name expansion and checking for valid addresses: The keys are the valid local parts and the values are the corresponding full names of the users.

Default: A single entry which corresponds to default_domain.

  • return_path_domain (string) — Domain used in the return address given to sendmail(8). Default: the default domain.
  • filter_domain_pattern (string) — A filter pattern which is equivalent to, or at least approximates the list of local domains. Default: the default domain.
  • hostname (string) — Hostname is the canonical name for this particular system, used in session and icon URLs which are generated by Prayer. This is derived automatically using gethostname(2) and gethostbyname(3) if no value is provided. However, there are situations, especially involving SSL certificates, where the default hostname may not be appropriate. The special value __UNDEFINED__ here means the startup script or command line must provide a hostname using a --config-option override or via the environment variable PRAYER_HOSTNAME. This is just a safeguard for systems which use DNS round robining to distribute load across a number of machines.
  • hostname_service (string) — Host name common for all Prayer installations part of the same webmail service. (Only) useful for large installations using DNS round robin for load balancing (example: webmail.hermes.cam.ac.uk is an alias for webmail[123].hermes.cam.ac.uk). This setting is used for two things: The user is redirected to this hostname after logging out, and HTTP requests are sanity checked against it in addition to the canonical hostname.

Default: none

  • fix_from_address (boolean) — suppresses the From address option from the Preferences and Roles screens. Default: false.
  • lookup_rpasswd (path) — Path to a CDB file that maps arbitrary search keys to colon- or comma-separated lists of user names. Note: Keys must be lowercase; Prayer converts search strings to lowercase in order to provide case-insensitive lookup.
  • lookup_rusername (path) — Path to a second CDB file that maps arbitrary search keys to colon- or comma-separated lists of user names.

If the user enters a valid and existing username according to getpwnam(3), Prayer does not search these first two CDB files, but skips directly to the second stage of looking up user information.

  • lookup_username (path) — Path to a CDB file that maps usernames to records consisting of the user's “registered name” and his/her affiliation (department), separated by a vertical bar (|). Additionally, if a second vertical bar follows, the account is regarded as cancelled.

When presenting the search results, the usernames found are combined with the default_domain to form email addresses. It is not possible at this time to let users search for addresses in more than one domain using this facility.

  • lookup_fullname (path) — Path to a CDB file that maps usernames to “display names”, possibly provided by the users themselves in some way. The display name of a user is used together with the email address in recipient fields

Note that all four lookup options must be set to valid CDB files for the local lookup to work, but more than one option may conceivably point to the same file.

  • ldap_server (string) — Name or address of LDAP server.
  • ldap_base_dn (string) — Base DN to search. After binding anonymously, Prayer performs a one-level-scope search for entries with surname or mail attributes containing the search string. The following attributes are fetched and presented:
    • uid
    • displayName
    • cn (“registered name”)
    • ou (“affiliation”)
    • mail
    • telephoneNumber
  • ldap_timeout (time) — Search timeout. Default: 30s.

🌈 HTTP and other frontend settings

  • use_http_port, use_https_port — Define a single HTTP[S] port to bind to. You can define an arbitary list of ports of both kinds by using a series of separate use_http_port and use_https_port directives, with one port on each line. Syntax:
use_http_port [interface:]port
use_https_port [interface:]port

can be an IP (v4 or v6) address or a hostname, bestie. If you actually give it one, that string gets handed straight to getaddrinfo(3) to be resolved, and the first address that comes back is the one it binds to. Don't give it one and prayer(8) just binds to port on every single interface. 💅

  • ssl_default_port (number) — when a browser shows up over plain HTTP and HTTPS sessions are also on offer, Prayer puts a little warning on the login page. This is the port that warning links to for the SSL version of the service; normally it defaults to port 443, or if that's not available, the first HTTPS port that's actually defined. Set ssl_default_port and you override all that built-in logic. 🎀

Lowkey you'll rarely need this now, because Prayer works out a suitable port by itself when you don't hand it one here. ✨

  • ssl_cert_file (path) — where your SSL certificate file lives (only used if SSL ports are defined). If you're serving SSL at all, this one is required. 🔐
  • ssl_privatekey_file (path) — where your SSL private key file lives (only used if SSL ports are defined). Also required if SSL services are happening. 🗝️
  • ssl_rsakey_lifespan (time) — the master server regenerates the shared RSA key on this interval. Default: 15m. ⏳
  • ssl_rsakey_freshen (time) — the RSA key stays fresh in a child process for this long after it's first actually used. Default: 15m. 🌱
  • ssl_session_timeout (time) — the SSL session cache TTL. Default: 0, i.e. the SSL session cache isn't used at all. If you do use it, run prayer-ssl-prune(8) on the regular so stale session data gets purged out of the DBD database. 🧹
  • egd_socket (path) — path to the entropy gathering daemon socket. Give it one and it gets used in place of or in addition to /dev/urandom. 🎲
  • contact_email (string) — the system administrator's email address. Heads up: this setting is currently not used. If you want support info visible to your users, go customise the templates instead. 📧
  • fatal_dump_core (boolean) — dump core on a fatal() error. Default: false. 💀
  • log_debug (boolean) — turn on somewhat more verbose logging, mostly SSL-related stuff. Default: false. 🔍
  • fix_client_ipaddr (boolean) — the client has to connect from consistent IP addresses. Can be a useful security measure on a LAN. It is painful for dialup users, whose connections may just drop out on them. Default: false. 😭
  • gzip_allow_nets (string), gzip_deny_nets (string) — prayer-session(8) gzip-compresses the pages it sends to clients only if all of these are true:
    1. gzip compression was enabled at compile time,
    2. use_gzip is set in the user's preferences,
    3. the user agent is known to support Content-Encoding: gzip,
    4. the user agent asks for Content-Encoding: gzip or x-gzip,
    5. the client's IP address appears in gzip_allow_nets, or the client's IP address does not appear in gzip_deny_nets.

The format of both options is a sequence of ipaddr[/masklen] items, separated by colons and whitespace (colons and spaces both, so IPv6 addresses stay easy to parse). Leave masklen off and the item is read as a full host address. 🦋

  • log_name_nets (string) — a network list in the exact same format as gzip_allow_nets above. So that logging in isn't delayed, prayer-session(8) only does a reverse lookup of the remote address if that address matches this list. Default: empty, meaning no reverse lookups get performed at all. 🌸
  • limit_vm (number) — a virtual memory limit slapped onto every process, so one runaway process can't take down the whole system. See setrlimit(2). Default: no limit. 🛑
  • http_max_method_size (number) — in theory Prayer copes with input of any size. In practice the incoming request has to be stored somewhere, and with no limits an attacker can eat all your memory and hand you a denial of service attack. This sets the maximum size of the initial line of an HTTP request. Default: no limit. 😬
  • http_max_hdr_size (number) — the maximum for the headers associated with this request. 📨
  • http_max_body_size (number) — the maximum for the HTTP payload. This is the most significant one in normal use. 📦
  • draft_att_single_max (number) — max size of a single attachment when composing a mail. Default: 0 (unlimited). 📎
  • draft_att_total_max (number) — max size of all attachments put together. Default: 0 (unlimited). 📎📎
  • http_min_servers (number) — minimum number of preforked prayer(8) HTTP servers. The master process forks new slave processes whenever the number of idle slaves drops below this, unless the total number of slaves would go over http_max_servers. Default: 4. 👑
  • http_max_servers (number) — maximum number of preforked prayer(8) HTTP servers, counting both active and idle ones. The master process does not enforce any maximum on idle slave processes though — they have to bow out voluntarily, either by timing out or by serving their maximum number of connections. Default: 64. 🫶
  • http_max_connections (number) — maximum number of connections each frontend server will process. Default: 0 (no limit). 🔗
  • http_timeout_idle (time) — timeout for a (dirty) spare server waiting around for another HTTP connection. Default: 30s. ⏱️
  • http_timeout_icons (time) — timeout for an HTTP connection that last served static content. Default: 10s. 🖼️
  • http_timeout_session (time) — timeout for an HTTP connection that last served a session URL, or that hasn't served anything yet. Default: 60s. 🕰️
  • http_cookie_use_port (boolean) — hand HTTP cookies to the browser as username:port=value instead of username=value. This lets one client browser run simultaneous login sessions. Downside: it can leave a trail of cookies behind you. You probably don't want this long term — right now it's here for experimentation purposes only. 🙈
  • icon_expire_timeout (time) — how far into the future to set the HTTP Expires: field for static content. Default: 7d. (By contrast, session URLs expire immediately: browsers really shouldn't be trying to cache this stuff, especially when it's coming in over HTTPS.) 🧚

🎀 Session specific configuration 🎀

  • session_idle_time (time) — the session switches into idle mode after this much time, and connections to IMAP and accountd servers get shut down. Default: 0 (idle mode disabled). 😴
  • session_timeout (time) — the session terminates after this much idle time. 0 means the session never times out. Default: 4h. ⌛
  • session_timeout_compose (time) — the session terminates after this much idle time instead, when the last command was compose or sieve. It should probably not be set lower than session_timeout. Default: 0 (always use the same timeout). ✍️
  • stream_ping_interval (time) — ping the INBOX, Other, and Draft streams at this interval. Default: 5m. 📡
  • stream_checkpoint (boolean) — use CHECKPOINT instead of PING to "ping" streams. Default: true. ✅
  • stream_misc_timeout (time) — shut down the Postponed, Preferences and Transfer streams entirely after this much idle time, but only if idle mode doesn't beat us to it first. Default: 0 (disabled). 🚪
  • log_ping_interval (time) — stat(2) the log files at this interval to see whether the target file has been renamed or removed. 0s means stat() the log file every single time something is logged. Default: 5m. 🗂️
  • db_ping_interval (time) — the interval at which to re-read the CDB files containing the local domain. Default: 30m. 🗄️
  • recips_max_msg (number) — maximum number of recipients per message. Default: 0 (unlimited). 💌
  • recips_max_session (number) — maximum number of recipients per session. If the limit gets hit and sending_block_dir is defined, a file is automatically created in sending_block_dir. Default: 0 (unlimited). 🧾
  • sending_allow_dir (path) — create an empty file named user in this directory to disable recips_max_session for that user. 🎟️
  • sending_block_dir (path) — create an empty file named user in this directory to disable outgoing email for that user (it's an automatic defense against phishing attacks). 🚫

🌸 Display specific configuration 🌸

  • login_banner (string) — used in the <title> and the heading of the login page. Default: "Webmail Service Login". 🏷️
  • login_service_name (string) — used in the <title> and elsewhere to refer to the webmail system after the user has logged in. Default: "Prayer". 💖
  • login_template (string) — the template to use on the login screen. 🎨
  • login_insert1_path (path) — optional file to include in the login page template (as $login_insert1). 🧩
  • login_insert2_path (path) — optional file to include in the login page template (as $login_insert2). 🧩
  • motd_path (path) — the file to use as the part of the login page immediately following the login form. 📜
  • ssl_encouraged (boolean) — if the user connects over unencrypted HTTP, don't show the login form on the start (/) page. A link to /login, where the form is still displayed, is still provided. Default: false. This is ignored if ssl_redirect or ssl_required is true. 🙅
  • ssl_redirect (boolean) — if the user connects over unencrypted HTTP, return a 302 redirect to the default SSL port. Only the start (/) page is redirected, and it may be possible to switch between http and https after logging in, subject to cookie rules. Default: false. ↪️
  • ssl_required (boolean) — return a 403 Forbidden error if the user tries to access anything at all over unencrypted HTTP. ssl_redirect still has effect, however. ⛔
  • list_addr_maxlen (number) — the maximum number of characters to show from addresses on the mailbox list screen. Default: 30. ✂️
  • list_subject_maxlen (number) — the maximum number of characters to show from the subject on the mailbox list screen. Default: 30. ✂️
  • change_max_folders (number) — the maximum number of folders allowed in the quick folder change dropdown list. If there would be too many folders, the quick list is disabled altogether. Only folders that are expanded in the folder view get included. Default: 20. 📁
  • template_path (path) — path to the uncompiled template sets (directories). Default: "../templates" (relative to tmp_dir). 🗺️
  • template_set (string) — the template set Prayer should use. Default: "xhtml_strict".
  • template_use_compiled (boolean) — rock the templates that are baked right into the binary and straight-up ignore template_path. Default: true.
  • theme — bestie, this one defines themes and their colors. It's semi-deprecated ngl 💀 — the colours you set with this directive are only used by the xhtml_transitional template set. The xhtml_strict template set, and the login screen too, use CSS instead. But you still gotta tell Prayer which themes are available. That part's non-negotiable.

Syntax:

theme name description description
theme name element colour
theme name element colour
...

description is the label that shows up in the theme dropdown lists on the General Preferences page.

element is one of fgcolor, fgcolor_link, bgcolor, bgcolor_banner, bgcolor_row1, bgcolor_row2, bgcolor_status, bgcolor_status_none, fgcolor_quote1, fgcolor_quote2, fgcolor_quote3, and fgcolor_quote4. The first three aren't used by any standard template set, but they're available if you want them. Please go study the templates to understand how the rest are used 👀.

colour is any valid HTML %Color value. Remember that strings containing hash marks need to be quoted. Yes really. Quote them.

  • theme_default_main (string) — the name of the default theme.
  • theme_default_main (string) — the name of the default theme in help mode.
ok so yes, this manpage genuinely lists theme_default_main twice with two different descriptions. That's not me glitching, that's just what it says. Keep both in mind. 🫶
  • use_ispell_language — the ispell languages we want to support, each with some descriptive text for the preferences screen. Syntax:
use_ispell_language wordlist description

Example:

use_ispell_language british "British English"

🛤️ Paths etc. 🛤️

  • aspell_path (path) — where the Aspell binary lives. This takes precedence over ispell_path.
  • bin_dir (path) — where the Prayer binaries live (prayer(8) and prayer-session(8)). Default: none. Must be set. No exceptions, bestie.
  • icon_dir (path) — where the icon files live. Default: none. Must be set.
  • ispell_path (path) — where the Ispell binary lives. Backwards compatibility only, so it's giving legacy energy.
  • log_dir (path) — where the log files live. Default: none. Must be set.
  • pid_dir (path) — where the PID files for the prayer and prayer-session master processes live. Default: none. Must be set.
  • sendmail_path (path) — where the sendmail binary lives, or a drop-in replacement like Exim. Default: /usr/lib/sendmail.
  • socket_dir (path) — where the unix domain sockets live that connect prayer(8) to prayer-session(8).
  • socket_split_dir (boolean) — split the socket directory into 64 subdirs keyed on the first letter of the sessionID. And the cute part? You can switch back and forth without moving sockets or killing sessions, because prayer(8) tries both variants. So really this setting just controls where prayer-session(8) creates the socket files. Default: false.
  • init_socket_name (string) — the name of the Unix domain socket (inside socket_dir) used for the initial handshake between the prayer and prayer-session processes when a user logs in. Default: none. Must be set.
  • ssl_session_dir (path) — where the SSL session cache database lives. Default: none. Must be set — even if the SSL session cache is disabled. Yes, even then. It's required regardless 💅.
  • static_dir (path) — where other static files (CSS) live. Default: none. If you leave it unset, Prayer will not serve CSS files at all.
  • tmp_dir (path) — since this is the directory both daemons chdir(2) to at startup, it's where temporary files get written — like attachments and folders that are in transit during upload and download operations. Core files also end up here, fun. Default: none. Must be set.

🎀 Defaults for user preferences 🎀

  • confirm_logout (boolean) — confirmation dialogue when the user logs out. Default: true.
  • confirm_expunge (boolean) — confirmation dialogue when the user hits expunge. Default: false.
  • confirm_rm (boolean) — confirmation dialogue when the user deletes a mail folder or directory. Default: true.
  • default_domain (string) — default domain for outgoing mail. Defaults to the hostname setting.
  • expunge_on_exit (boolean) — expunge deleted messages from the inbox automatically on logout. Default: false.
  • html_inline (boolean) — show text/html bodyparts inline. The content gets scrubbed to remove dangerous tags. If this is set, text/html will be displayed in preference to text/plain. Default: true.
  • html_remote_images (boolean) — show remote images automatically. If this is not set, "Show unsafe images" links will appear on pages showing HTML mail. Default: false.
  • html_inline_auto (boolean) — same as above, but for text/* bodyparts which start with "<HTML>" (case-independent!). Does anyone other than spammers actually use this? 🙈 Default: true.
  • ispell_language (string) — language for ispell. Default: "british".
  • msgs_per_page (number) — number of messages per screen on the message list screen. Default: 12.
  • msgs_per_page_max (number) — the maximum value users are allowed to set msgs_per_page to. Default: 50.
  • msgs_per_page_min (number) — the minimum value users are allowed to set msgs_per_page to. Default: 4.
  • abook_per_page (number) — number of addressbook entries per page on the address book list screen. Default: 12.
  • abook_per_page_max (number) — the maximum value users are allowed to set abook_per_page to. Default: 50.
  • abook_per_page_min (number) — the minimum value users are allowed to set abook_per_page to. Default: 4.
  • maildir (string) — mail directory in the user's account. Default: "". Typically needed with uw-imap. Typically not needed with e.g. Dovecot or Courier.
  • suppress_dotfiles (boolean) — suppress dotfiles from the directory listing. Default: true.
  • postponed_folder (string) — name of the folder where messages to be sent later — a.k.a. drafts — are stored. Default: "postponed-msgs".
  • sent_mail_folder (string) — name of the folder for sent mail. Default: "sent-mail".
  • small_cols (number) — width of the small compose textarea in columns. Default: 80.
  • small_rows (number) — height of the small compose textarea in lines. Default: 18.
  • large_cols (number) — width of the large compose textarea in columns. Default: 80.
  • large_rows (number) — height of the large compose textarea in lines. Default: 32.
  • sort_mode (string) — default sort mode for the mailbox list. One of ARRIVAL, DATE, FROM, TO, CC, SIZE, SUBJECT, REFERENCES, ORDEREDSUBJECT. Default: ARRIVAL is most efficient, and recommended.
  • sort_reverse (boolean) — favour reverse sort rather than normal sort order? Default: false.
  • abook_sort_mode (string) — default sort mode for the addressbook list. One of: ORDERED, ALIAS, NAME, COMMENT, ADDRESS. Default: ORDERED.
  • abook_sort_reverse (boolean) — favour reverse sort rather than normal sort order? Default: false.
  • line_wrap_len (number) — wrap lines at this many characters. Default: 76.
  • line_wrap_advanced (boolean) — enable advanced line wrap options? Default: false.
  • line_wrap_on_reply (boolean) — line wrap automatically on reply. Default: true.
  • line_wrap_on_spell (boolean) — line wrap automatically on spell check. Default: true.
  • line_wrap_on_send (boolean) — line wrap automatically on send. Default: true.
  • preserve_mimetype (boolean) — send the message Content-Type through to the browser. If false, Content-Type is replaced with ‘application/octet-stream’, which should force download to local disk, bypassing any automatic processing of bodyparts by the User-Agent. Unclear at the moment whether we need to do this, or whether this should be done selectively based on the User-Agent. Default: true.
  • use_sent_mail (boolean) — make the "Save copy" checkbox on the compose screen checked by default. Default: true.
  • use_mark_persist (boolean) — use persistent mark for aggregate operations. Default: false.
  • use_search_zoom (boolean) — zoom automatically after a successful search. Default: true.
  • use_agg_unmark (boolean) — unmark messages after a successful aggregate operation. Default: true.
  • use_icons (boolean) — use icons: may be overridden by the value of the User-Agent. Default: true.
  • use_welcome (boolean) — enable the welcome screen. Default: true.
  • use_tail_banner (boolean) — duplicate the banner icons (toolbar) at the bottom of the Message screen. Default: true.

🙈 Hidden preferences 🙈

The following options are internally handled as user preferences, but the Preferences screen no longer provides any means for changing them. So they're just... vibing in there. Iykyk.

  • use_cookie (boolean) — use an HTTP cookie for the Session-ID, if the browser supports cookies. If this is disabled, or the user rejects the cookie, then the session-ID is stored in the URL instead. Default: true.
  • use_substitution (boolean) — use page substitution rather than HTTP redirects. Faster, but the URLs that get generated are less predictable. Page substitution and the browser history mechanism don't coexist well at the moment (Prayer would need to cache the final page value for each substitution event).

Default: true.

  • use_http_1_1 (boolean) — allow HTTP/1.1, if the browser supports it. Default: true.
  • use_pipelining (boolean) — allow HTTP/1.1 pipelining, if the browser supports it. Default: true.
  • use_persist (boolean) — allow persistent HTTP/1.1 and HTTP/1.0 persistent connections, if the browser supports them. Default: true.
  • use_short (boolean) — allow short URLs, if the browser supports them. Default: true.
  • use_gzip (boolean) — allow gzip compression, if the browser supports it. Default: true.

✨ SEE ALSO ✨

prayer(8), prayer-session(8)

👑 AUTHORS 👑

This manual page was put together by Magnus Holmgren <holmgren@debian.org> using documentation written by David Carter <dpc22@cam.ac.uk>.

and that's the whole page, bestie 💖 The Prayer Webmail Interface, dated 17 August 2008, living in section PRAYER.CF(5). Go forth and configure, you absolute icon 🎀✨🦋

📦 where this page comes from