# OpenWebMail configuration file HELP ############################################################################## # host dependent configuration ############################################################################## domainnames ----------------------------------------------------------------------- default domainnames for user's outgoing mail domain. If set this to auto, then the default domainnames may come from: 1. if @domainname is specified in username, then that domain will be used 2. if the option enable_domainselectmenu is set to yes, then the one chosen from the domain select menu will be used 3. $ENV{HTTP_HOST} will be used (the hostname in URL). 4. If $ENV{HTTP_HOST} is IP, we get this by running '/bin/hostname' Example: domainnames auto domainnames server1.domain1.com, server2.domain2.com ps: domains specified in this option should be equivalent ones, in short, they are domains with exactly same group of users. If you have virtual domains that are actually independent, you should leave this to auto, and try to a. set option enable_domainnameselectmenu to yes, and b. specify all virtualdomains in the option domainselectmenu_list smtpserver ----------------------------------------------------------------------- The SMTP servers will be relayed by openwebmail for outgoing mail If you are running smtp daemon(ex: sendmail) on this host, you can set this to '127.0.0.1', or you can set this to either a hostname.domain or ip address of a remote server that will do relay for you. You may list more than one smtpserver here. If the first server is unavailable, the next server will be tried and so on. Each server should be separated by a comma: 127.0.0.1, 198.168.2.1, etc smtpport ----------------------------------------------------------------------- The port which the SMTP daemon on smtpserver listens to smtpauth ----------------------------------------------------------------------- If this option is set to yes, openwebmail will use the username/password defined in smtpauth.conf to pass the SASL authentication on SMTP server virtusertable ----------------------------------------------------------------------- the location of sendmail virtusertable. It is used to map a virtualuser to the real userid in system. A virtualuser can be in the form a pure username or username@somedomain Pls Refer to http://www.sendmail.org/virtual-hosting.html for more detail When a user logins OpenWebMail with a loginname, this loginname will be checked in the following order: 1. Is this loginname a virtualuser defined in virtusertable? 2. Is this loginname a real userid in system? Please refer to readme.txt for more information auth_module ----------------------------------------------------------------------- the authentication module used in openwebmail auth_module authentication by -------------- --------------------------------------- auth_ldap.pl ldap server auth_mysql.pl mysql server (DBI interface) auth_mysql_vmail.pl mysql server (optimized for vmail) auth_pam.pl pam (pluggable authentication module) auth_pam_cobalt.pl pam on cobalt (pluggable authentication module) auth_pg.pl postgres server (pgsql interface) auth_pgsql.pl postgres server (DBI interface) auth_pop3.pl remote pop3 server auth_unix.pl unix passwd auth_unix_cobalt.pl unix passwd (optimized for Sun Cobalt servers) auth_vdomain.pl passwd of vdomain on vmpop3d+postfix IMPORTANT!!! You may get more information by reading the description in the beginning of each auth module script. Once you have decided which module to use, don't forget to edit the global variables defined in the module auth_withdomain ----------------------------------------------------------------------- Set this option to 'yes' if the the user to be authenticated by auth_module is in the form of 'username@domainname auth_domain ----------------------------------------------------------------------- When previous option auth_withdomain is set to yes, the domain may come from serverial sources: 1. the domain mapped by virtusertable 2. the domain part in loginname specified by user (or the domain chosen in the domainname select menu) 3. the domain in the webmail URL 4. the domain by /bin/hostname Since the derived domain may be not the one you want to pass to auth system, you may override it with this option. Example: auth_domain server1.domain1.com ps: please refer to doc/loginprocess.txt for more information quota_module ----------------------------------------------------------------------- the quota module used to calculate user quotausage and quotalimit, if this option is set to 'none', then no quota counting will be used at all. module implemented by -------------- --------------------------------------- none no quota system used at all quota_unixfs.pl user quota info from unix filesystem quota_du.pl user quota reported by 'du' program IMPORTANT!!! You may get more information by reading the description in the beginning of each quota module script in the quota directory. mailspooldir ----------------------------------------------------------------------- This is where your user mail spools are kept. This value will be ignored if you're using a system that doesn't store mail spools in a common directory, and you set homedirspools to 'yes' use_hashedmailspools ----------------------------------------------------------------------- Set this to 'yes' if your mail spool directory is set up like /var/spool/mail/u/s/username. Most default sendmail installs aren't set up this way, you'll know if you need it. use_syshomedir ----------------------------------------------------------------------- If set this option to 'yes', openwebmail will use the user homedir returned by authentication system. (eg: the homedir assigned in /etc/passwd) If set this option to 'no', openwebmail will provide homedir for the user in the directory specified by option ow_usersdir. (default location: %ow_usersdir%/username/ or %ow_usersdir%/domain/username/ if option auth_withdomain is yes) create_syshomedir ----------------------------------------------------------------------- If previous option 'use_syshomedir' is set to 'yes' and the user homedir assigned in authentication system doesn't exist, openwebmail will create the directory if this option is set to 'yes' use_homedirspools ----------------------------------------------------------------------- Set this to 'yes' if you're using mailspool files in user homedir homedirspoolname ----------------------------------------------------------------------- the filename of the mailspool in user home directories. homedirfolderdirname ----------------------------------------------------------------------- Set this to 'mail' to use ~user/mail/ for user's homdirfolders, it is compatible with 'PINE' MUA. homedirdotdirname ----------------------------------------------------------------------- This is the location under user homedir where openwebmail related files are stored. The default is .openwebmail use_syshomedir_for_dotdir ----------------------------------------------------------------------- whether to put dotdir (.openwebmail) under syshomedir The .openwebmail dir is put at ~user/.openwebmail by default, But if this option is set to 'no', then .openwebmail will be put at %ow_usersdir%/user/.openwebmail instead This option is useful for systems using syshomedir and running quota. Placing .openwebmail outside user syshomedir can avoid folder db index updating error caused by quota limit ps: In our experience, the folder db size is about 0.3% to 0.8% of the folder file, you can estimate the space required for %ow_usersdir% based on the ratio. deliver_use_gmt ----------------------------------------------------------------------- Set this to 'yes' if you mail deliver uses GMT time in the delimiter line when writing new messages to mailspool. eg: Qmail is known to use GMT time in mail delivery. zonetabfile ----------------------------------------------------------------------- Points to the zone.tab, usually /usr/share/zoneinfo/zone.tab. This will correctly handle DST. Set to 'no' for simple timezone handling (old behaviour). NOTE: If you are upgrading from the old timezone handling, existing users will not have the 'timezone' set in their openwebmailrc files (setting the default_timezone in openwebmail.conf only affects new users). In this case, it has to be configured either on their openwebmailrc, or through the user settings page. See default_timezone setting description. ############################################################################## # openwebmail system configuration ############################################################################## ow_cgidir ----------------------------------------------------------------------- the directory for openwebmail cgi programs ow_cgiurl ----------------------------------------------------------------------- the url for ow_cgidir ow_htmldir ----------------------------------------------------------------------- the directory for openwebmail webpage/image/sound files ow_htmlurl ----------------------------------------------------------------------- the url for ow_htmldir ow_etcdir ----------------------------------------------------------------------- The directory for 1. system config (defaults/openwebmail.conf and openwebmail.conf), 2. runtime created system-wide db (need about 10mb), 3. and the default parent directory for the following runtime resources. (styles, lang, templates, sites.conf, users.conf, users, sessions) ps: No matter what value is set in this option, openwebmail will always locate the defaults/openwebmail.conf and openwbemail.conf in %ow_cgidir%/etc ow_layoutsdir ----------------------------------------------------------------------- the path to the root directory for storing layouts. ow_layoutsurl ----------------------------------------------------------------------- the url to the root directory for storing layouts. ow_langdir ----------------------------------------------------------------------- the directory for string definitions of different languages ow_templatesdir ----------------------------------------------------------------------- the directory for html templates of different languages ow_holidaysdir ----------------------------------------------------------------------- the directory for calendar book of holidays of different languages ow_mapsdir ----------------------------------------------------------------------- the directory for maps (eg:big5<->gb, solar<->lunar) and the db of maps ow_sitesconfdir ----------------------------------------------------------------------- the directory for openwebmail per site config ow_usersconfdir ----------------------------------------------------------------------- the directory for openwebmail per user config ow_usersdir ----------------------------------------------------------------------- the directory for openwebmail users to store their messages, personal preferences, signatures, webdisk files and addressbooks in. This option is used ONLY if option use_syshomedir is set to 'no' This directory would become very large if you have many webmail users, so please put it in a partition with enough space. It is strongly recommended that the ow_usersdir NOT be directly accessable via a URL on the webserver. If you put the ow_usersdir somewhere that can be accessed by URL, users will be able to upload malicious scripts via webdisk and then execute them with the permissions of the webserver. ow_sessionsdir ----------------------------------------------------------------------- the directory for openwebmail temporary session files and attachments currently used by each session. ps: This directory would become very large if you have many concurrent webmail users. So please put it in a partition with enough space. ps: The permission for ow_usersdir and ow_sessionsdir directories should be mode: 750 owner: the user that OWM script will be running as (root in many cases) group: mail ow_addressbooksdir ----------------------------------------------------------------------- the directory for global addressbooks start_url ----------------------------------------------------------------------- The url of the start page for openwebmail login. Set this option if you have customized start page for openwebmail login, so [continue] button at logout page can lead your user to correct page ico_url ----------------------------------------------------------------------- The graphic that is used as the shortcut icon for openwebmail. The icon is 16x16 in size and has to be in Windows ico format to work with IE6. Mozilla can use any format (png etc). logo_url ----------------------------------------------------------------------- This graphic that appears at the top of openwebmail login pages. logo_link ----------------------------------------------------------------------- The link to go when user clicks the logo image help_url ----------------------------------------------------------------------- The url of webpage to display when user clicks the help link or presses F1 key. If this is set to @@@HELP_URL@@@, the url of openwebmail help tutorial of the user language will be used. help_text ----------------------------------------------------------------------- The text label for the help url If this is set to @@@HELP_TEXT@@@, the word 'Help' translated from the user language will be used. logfile ----------------------------------------------------------------------- This should be set either to 'none' or the filename of a file you'd like to log actions to. global_filterbook ----------------------------------------------------------------------- filterbook shared by all user global_calendarbook ----------------------------------------------------------------------- calendarbook shared by all user g2b_map ----------------------------------------------------------------------- chinese GB to Big5 mapping txt file b2g_map ----------------------------------------------------------------------- chinese Big5 to GB mapping txt file lunar_map ----------------------------------------------------------------------- solar to lunar calendar mapping txt file (1936..2031) header_pluginfile footer_pluginfile ----------------------------------------------------------------------- the files to be plugined at the header or footer of main pages of webmail/abook/calendar/webdisk. If this option is set to 'none', the plugin will be disabled ps: To plugin the output of a program into openwebmail, you may have two choices: a. specify the plugin file as a pipe, eg: "/somepath/your_program |" b. execute the command in crontab, then use the output file of command as the pluginfile While method 1 is more realtime, moethod 2 would have samller overhead. ps: You may use %THISSESSION% in the plugin output, which will be replaced with the user current sessionid in openwebmail, this may be useful if your plugin want to call links inside openwebmail webmail_middle_pluginfile ----------------------------------------------------------------------- this option is similar as above, but the content of the pluginfile will embedded between the menu bar and the messagelist in webmail folderlist. header_pluginfile_charset footer_pluginfile_charset webmail_middle_pluginfile_charset ----------------------------------------------------------------------- these options are used to specify the charset of the plugin data, so openwebmail will convert the charset of plugin data in case the user is using different charset ps: these options are set to 'none' by default, which means no charset conversion at all for plugin data spellcheck ----------------------------------------------------------------------- The command to trigger your spelling check program Example: (for ispell, http://fmg-www.cs.ucla.edu/geoff/ispell.html) spellcheck /usr/local/bin/ispell -a -S -w "-" -d @@@DICTIONARY@@@ -p @@@PDICNAME@@@ Example: (for aspell, http://aspell.sourceforge.net/)" spellcheck /usr/local/bin/aspell -a -S -w "-" -d @@@DICTIONARY@@@ -p @@@PDICNAME@@@ ps: @@@DICTIONARY@@@ will be replaced with the dictionary user choose to use at runtime @@@PDICNAME@@@ will be replaced with the value defined in option spellcheck_pdicname spellcheck_pdicname ----------------------------------------------------------------------- The filename of the personal dictionary Example: (for ispell) spellcheck_pdicname .ispell_words' Example: (for aspell) spellcheck_pdicname .aspell.@@@DICTIONARY@@@.pws spellcheck_dictionaries ----------------------------------------------------------------------- The names of all dictionaries supported by your spellcheck program. note: If your dictionary checks vocabularies composed by characters other than english letters, you have to define new entries in %dictionary_letters for the dictionary in openwebmail-spell.pl vacationinit ----------------------------------------------------------------------- The location of the vacation program with parm to init the vacation db vacationpipe ----------------------------------------------------------------------- The location of the vacation program with option to read data piped from sendmail. 60s means mails from same user within 60 seconds will be replied only once domainname_equiv ----------------------------------------------------------------------- This is used to define domainnames that are equivalent for each domain of this server. Openwebmail determines the user login domain from the following order: 1. loginname input at the login page, 2. hostname in the URL 3. /bin/hostname This domainname_equiv is used to map the domainnames from the above sources to a consistent one. For example: Your server supports 2 email domains: sample.com and sample2.com, but it is known as mail.sample.com, www.sample.com, webmail.sample.com mail.sample2.com, www.sample2.com, webmail.sample2.com Now you hope no matter what domainname user used in loginname or URL of login page, they will be recognized as samepl.com or sample2.com. You can define the following domainname equivalence: sample.com: mail.sample.com, www.sample.com, webmail.sample.com sample2.com: mail.sample2.com, www.sample2.com, webmail.sample2.com This is very useful if you want to use the per site conf feature. In above example, you use sample.com and sample2.com for the conf filename of the two virtual domain, and they will applied to all the above cases. The domainname_equiv is also used in the virtusertable alias mapping. When trying to find a real user from virtusertable, openwebmail will refer to the domainnam_equiv table to find the possible alias entry to use. ps: please refer to doc/loginprocess.txt for more information error_with_debuginfo ----------------------------------------------------------------------- If this option is set to yes, detailed debug info (including scriptname, line number, real uid, effective uid, real uid, mailgid) will be put into the error message. debug_request ----------------------------------------------------------------------- If this option is set to yes, info of each request will be logged debug_fork ----------------------------------------------------------------------- If this option is set to yes, info of forked process will be logged debug_maildb ----------------------------------------------------------------------- If this option is set to yes, details of the maildb will be logged debug_maildb_buffer ----------------------------------------------------------------------- If this option is set to yes, details of the maildb buffers will be logged debug_mailprocess ----------------------------------------------------------------------- If this option is set to yes, details of mail processing will be logged debug_mailfilter ----------------------------------------------------------------------- If this option is set to yes, details of mail filter will be logged iconv_error_labels ----------------------------------------------------------------------- If this option is set to yes, characters that are not successfully converted will be prefixed with the character set that they failed to convert from, for example: [UTF-8?]foo This option is available to expose character conversion problems to developers. Since its results can be confusing to normal users it is recommended to be primarily used in developers per user config files. allowed_serverdomain ----------------------------------------------------------------------- This limits the virtualdomain that openwebmail will serve. If this option is empty or 'all', request to any hostname will be served. If this option is 'none', no request be served, this disables openwebmail. If this option is a list of domainname tokens separated by comma, request will be served only if the hostname in URL($ENV{HTTP_HOST}) appears in list The default is all. Example: allowed_serverdomain virtualdomain1.com, virtualdomain2.com allowed_clientdomain ----------------------------------------------------------------------- This limits the clients access by their domainname If this option is empty or 'all', any client can access the system. If this option is 'none', no client can access the system. If this option is a list of domainname tokens separated by comma, then only clients whose domainname matches the tokens from the tail can access the openwebmail system The default is all. Example: allowed_clientdomain ee.ncku.edu.tw, hosp.ncku.edu.tw allowed_clientip ----------------------------------------------------------------------- This limits the clients accesses by their ip address Only clients whose IP address matches these tokens from the beginning can access the openwebmail system The default is all. Example: allowed_clientip 140.116.72., 192.168. ps: A valid client has to pass both domain and ip check. allowed_receiverdomain ----------------------------------------------------------------------- This limits the receiver the user can send mail to. If this option is empty or 'all', the mail can be sent to any email address. If this option is 'none', the mail can not be sent to any email address. If this option is a list of email domain tokens separated by comma, then user can only send mail to email address which matches the tokens from tail The default is all. Example: allowed_receiverdomain company.com, someone@company2.com allowed_autologinip ----------------------------------------------------------------------- This limits the clients that can use autologin by their ip address If this option is empty or 'all', any client can use autologin If this option is 'none', no client can use autologin If this option is a list of ips separated by comma, only clients whose IP address matches these tokens from the beginning can use autologin. The default is all. ps: Sysadm may use this option to limit autologin feature so it is only available to computers inside the company/organization. Example: allowed_autologinip 140.116.72., 192.168. allowed_rootloginip ----------------------------------------------------------------------- This limits the clients that can login as root user in openwebmail. If this option is empty or 'all', any client can login as root If this option is 'none', no client can login as root. If this option is a list of ips separated by comma, only clients whose IP address matches these tokens from the beginning can login as root The default is none. Example: allowed_rootloginip 140.116.72., 192.168. login_fieldwidth ----------------------------------------------------------------------- The width of the username and password fields in the login login_virtual_keyboard ----------------------------------------------------------------------- Set this to 'yes' if you want a virtual keyboard to appear next to the password field on the login page. The virtual keyboard allows users to enter their password with the mouse instead of the keyboard. This addresses a security concern if your users use public machines because they may have keylogging spyware installed which can steal passwords entered via keyboards case_insensitive_login ----------------------------------------------------------------------- Set this to 'yes' if you want case insensitive login in openwebmail, then user loginname will be converted into lower case before passing to authentication system. forced_ssl_login ----------------------------------------------------------------------- Set this to 'yes' if you want to force the use of SSL in login page stay_ssl_afterlogin ----------------------------------------------------------------------- While SSL can be used to protect data transfered on the network, it requires more server power. If set this option to 'no', only login and change password page will use SSL. enable_domainselectmenu ----------------------------------------------------------------------- Set this to 'yes' if you want a selection menu at login This could be useful if you have more than one virtual domains setup on same host domainselectmenu_list ---------------------------------------------------------------------- This is the domainnames that will be listed in the above selection menu If this option is set to 'auto', the entries will be derived from option domainnames Example: domainselectmenu_list server1.domain1.com, server2.domain2.com enable_strictvirtuser ----------------------------------------------------------------------- When an account has been mapped by a virtuser in virtusertable, both the account and the virtuser can be used as the login name in OpenWebMail. If this option is set to 'yes', then only the virtuser can be used for login. enable_changepwd ----------------------------------------------------------------------- Set this to 'yes' if you want to let user set their password through the web mail interface enable_strictpwd ----------------------------------------------------------------------- Set this to 'yes' if you want openwebmail to do strict checking on the new password while changing the old password. It will deny passwords containing only alphabets or digits. passwd_minlen ----------------------------------------------------------------------- The minimum length for the new password in changing password session_multilogin ----------------------------------------------------------------------- Set this option to 'no' would disable multi-login for same user session_checkcookie ----------------------------------------------------------------------- Set this option to 'no' would allow client to connect even it doesn't support cookie, this gives better compatibility with some browser. session_checksameip ----------------------------------------------------------------------- Set this option to 'no' would allow client ip change in same session This could be useful for dial up user who may want to continue the same session after his has been off line for a while ps: We suggest you at least set one of the two options: session_checkcookie or session_checksameip to yes, or the user session may be hijacked by others. session_count_display ----------------------------------------------------------------------- Set this option to 'no' if you don't want the count of active sessions in the past 1, 5, 15 minutes to be displayed at the user login cache_userinfo ----------------------------------------------------------------------- Openwebmail will cache the user info (uid, gid, homedir...) in per session base. This reduces the requests to auth system and thus gives some speedup on slow auth systems (eg: auth system is remote server or database) Set this option to 'no' will disable this feature, but the change you made to auth system will reflect immediately. auto_createrc ----------------------------------------------------------------------- If this option set set to 'yes', the default preference settings will be saved to .openwebmairc automatically for the firsttime login user. And the user will be lead to folderview directly instead of the preference setting menu. domainnames_override ----------------------------------------------------------------------- The domainame for the user default email comes from the following source: 1. the domainname of the virtualuser defined in the virtusertable 2. the domainname defined in the option domainnames in openwebmail.conf 3. the domainname in the URL line The former sources will override the later. If you set 'domainnames_override' to yes, then source 2 will override source 1. ps: please refer to doc/loginprocess.txt for more information symboliclink_mbox ----------------------------------------------------------------------- Some pop3d uses both mail spool and ~user/mbox as the storage for messages. A new message is put into mail spool by mail deliver at the begining. When a user chooses to "reserve the messages on server" in his pop3 client, an read message will be moved from mail spool to ~user/mbox by the pop3d. Since ~user/mbox is not a folder in openwebmail, user won't see the messages in ~user/mbox. With this option set to 'yes', openwebmail will symbolic link ~/mbox -> ~/mail/saved-messages, so users can access the read messages from either pop3 client or openwebmail enable_webmail ----------------------------------------------------------------------- set this option to 'no' if you want to disable webmail related functions enable_addressbook ----------------------------------------------------------------------- set this option to 'no' if you want to disable addressbook related functions enable_userfolders ----------------------------------------------------------------------- set this option to 'no' if you want to disable user created folders enable_spellcheck ----------------------------------------------------------------------- Set this option to 'no' if you want to disable the spellcheck feature in composing message enable_advsearch ----------------------------------------------------------------------- Set this option to 'no' if you want to disable the advanced search feature enable_calendar ----------------------------------------------------------------------- OpenWebMail has built-in clendar support, set this option to 'no' if you want to disable it. enable_webdisk ----------------------------------------------------------------------- OpenWebMail has built-in web disk support, set this option to 'no' if you want to disable it. enable_urlattach ----------------------------------------------------------------------- Controls whether or not users may attach files when composing messages by providing a url. The file the url is pointing to is downloaded by the mailserver and attached to the message. This bandwidth of the mailserver is used to perform the download using the wget commandline program. The wget program is also required to be installed on the mailserver for this feature to work. If wget is not installed this feature is automatically disabled. set this option to 'no' if you want to disable it. enable_sshterm ----------------------------------------------------------------------- If this option is set to 'no', then the SSH terminal button won't be available to the user. ps: To completely disable the SSH terminal support, you have to remove the file data/openwebmail/applet/mindterm/mindtermfull.jar enable_vdomain ----------------------------------------------------------------------- OpenWebMail has a build-in vm-pop3d/postfix virtual domain user manager. If this option is set to 'yes', the virtual domain manager will be available to the users that are specified in option vdomain_admlist. enable_preference ----------------------------------------------------------------------- set this option to 'no' if you want to disable preference setup fir users Note: Openwebmail will try to guess the proper value for user preference in case this is set to no, but we don't guarentee that user will like those values :) enable_history ----------------------------------------------------------------------- Set this to 'no' if you want to disable the 'History' feature in the user preference enable_about ----------------------------------------------------------------------- Set this to 'no' if you want to disable the 'About' button in the user preference about_info_software ----------------------------------------------------------------------- If cleared, the SOFTWARE part of the About dialog is not available. It contains OS, Perl and OpenWebMail versions. You might find it undesirable for these data to be printed, it could help someone identify your system software as vulnerable if, say, an openwebmail or Perl exploit were found. ps: if enable_about or about_info_software is set to 'no', then the version number and releasedate of openwebmail won't be displayed in the copyright page. about_info_scriptfilename ----------------------------------------------------------------------- This one is probably better off being left as is. Enabling it might reveal the DocumentRoot of the www server, which is generally a Bad Thing(tm). about_info_protocol about_info_server about_info_client ----------------------------------------------------------------------- Other information part of the About dialog. For completeness only. xheaders ----------------------------------------------------------------------- This is used to define the additional headers that would be added to the header of all outgoing messsages eg: X-Mailer: %name% %version% %releasedate% %revision% X-OriginatingIP: @@@CLIENTUP@@@ (@@@USERID@@@) ps: please note that all xheaders must be started with X- enable_loadfrombook ----------------------------------------------------------------------- This option controls whether the email defined in ~user/.from.book should be loaded as the user from email addresses enable_editfrombook ----------------------------------------------------------------------- This option would allow user to edit their 'from book' for different name and emails frombook_for_realname_only ----------------------------------------------------------------------- This option limit the useage of user from book for changing the realname only, so user can not change the address part of email address enable_autoreply ----------------------------------------------------------------------- This option would allow user to enable autoreply for incoming messages enable_setforward ----------------------------------------------------------------------- This option would allow user to set their ~/.forward which will forward their mail to other server automatically enable_strictforward ----------------------------------------------------------------------- If this option is to yes, any shell escaped character in ~/.forward will be treated as invalid. enable_stationery ----------------------------------------------------------------------- This option enables the stationery support enable_savedraft ----------------------------------------------------------------------- This option enables the 'save draft' support in message composing enable_backupsent ----------------------------------------------------------------------- This option enables the 'backup sent' support in message composing enable_globalfilter ----------------------------------------------------------------------- Messages of all users will be filtered by the rules defined in the file specified option global_filterbook, set this option to 'no' if you want to disable this feature. enable_userfilter ----------------------------------------------------------------------- OpenWebMail default allows user to define mail filters for his incoming messages, set this option to 'no' if you want to disable it. enable_smartfilter ----------------------------------------------------------------------- OpenWebMail has 5 smart filters: repeatness filter, badformat from filter, fakedsmtp filter, fakedfrom filter and faked exe contenttype filter, set this option to 'no' if you want to disable it. smartfilter_bypass_goodmessage ----------------------------------------------------------------------- If a message is sent by OpenWebMail or is an reply message, then we bypass the smart filters check for this message. Set this to 'no' if you hope to apply smart filters on these good messages enable_viruscheck ----------------------------------------------------------------------- This option enables external virus checker (clamav). The virus checker in OpenWebMail is intended to check messages that arrive without going through the system MTA - such as POP3 messages. However it can also be used to check all messages by configuring the viruscheck_source_allowed option, in the case that the MTA does not perform virus checking - although it is recommended to check messages at the MTA and not OpenWebMail whenever possible. viruscheck_pipe ----------------------------------------------------------------------- The location of the virus check program with parmeters to read a message from the stdin viruscheck_include_report ----------------------------------------------------------------------- If the viruscheck_pipe is configured to return a report on which virus tests were hit, this option will include that report in the header of the infected message. Convenient for determining why a message has been flagged as infected. viruscheck_source_allowed ----------------------------------------------------------------------- this option limits the value that user can set for viruscheck_source in preference. available value: all, pop3 viruscheck_maxsize_allowed ----------------------------------------------------------------------- this option limits the max value that user can set for viruscheck_maxsize in the user preference. (in KB) Value: 250, 500, 1000, 2000, 3000, 4000, 5000, 10000, 20000, 50000 virus_destination ----------------------------------------------------------------------- The folder to be moved to for messages with virus (default: virus-mail) has_virusfolder_by_default ----------------------------------------------------------------------- Set this option to no if you don't want virus-mail being displayed as one of the default folders enable_spamcheck ----------------------------------------------------------------------- This option enables external spam checker (spamassassin). The spam checker in OpenWebMail is intended to check messages that arrive without going through the system MTA. This means by default it will only check messages fetched using the POP3 protocol It -can- be configured to check ALL messages, when used in conjunction with the spamcheck_source_allowed option. This is for cases where the MTA does not perform spam checking. However, it is strongly recommended to configure spam checking at the MTA level and not OpenWebMail whenever possible spamcheck_source_allowed ----------------------------------------------------------------------- This option limits the value that a user can choose for the spamcheck_source in their preferences The 'all' setting will allow users to set the spamcheck_source to check all messages that arrive in their inbox, even if they have already been checked by the MTA. This setting is not recommended since it will delay login while all incoming messages are checked The 'pop3' setting will allow users to set the spamcheck_source to check only messages that arrive via the POP3 protocol. This is the default The 'none' setting disables the users ability to select the spamcheck_source The 'all' and 'pop3' options also include the 'none' option for the user. To force a selection that the user cannot change use the DEFAULT_spamcheck_source_allowed override version of this configuration option Available values: none, all, pop3 spamcheck_pipe ----------------------------------------------------------------------- The location of the spam check program, with parameters to read a message from the STDIN. Admins should test this command on the commandline using a single raw message. Spamassassin spamc must be able to correctly connect to spamd to process the message. Make sure you are also connecting to the correct spamd port. Spamd must be running for OpenWebMail to process spam properly. spamcheck_include_report ----------------------------------------------------------------------- If the spamcheck_pipe is configured to return a report on which spam tests were hit, this option will include that report in the header of the spammy message. Convenient for determining why a message has been flagged as spam. spamcheck_maxsize_allowed ----------------------------------------------------------------------- This option limits the max value that user can set for spamcheck_maxsize in the user preference. (in KB) Value: 100, 150, 200, 250, 300, 350, 400, 450, 500, 600, 700, 800, 900, 1000 spam_destination ----------------------------------------------------------------------- The folder to be moved to for spam messages (default: spam-mail) has_spamfolder_by_default ----------------------------------------------------------------------- Set this option to no if you don't want spam-mail being displayed as one of the default folders enable_learnspam ----------------------------------------------------------------------- This option enables the spam learner (sa-learn) ps: while enable_spamcheck is off, the system may still have spam check support in MTA or local deliver, so this learnspam option is independant with enable_spamcheck learnspam_pipe ----------------------------------------------------------------------- The location of the spam learn program with parmeters to learn SPAM message from the stdin learnham_pipe ----------------------------------------------------------------------- The location of the spam learn program with parmeters to learn HAM message from the stdin ps: HAM = non-SPAM learnspam_destination ----------------------------------------------------------------------- If a message is learned as SPAM and it IS NOT located in either spam-mail or virus-mail, then this is the folder that the learned message will be moved to. (default: spam-mail) learnham_destination ----------------------------------------------------------------------- If a message is learned as HAM and it IS located in either mail-trash, spam-mail or virus-mail, then this is the folder that the learned message will be moved to. (default: INBOX) enable_saprefs ----------------------------------------------------------------------- If this option is set to yes, user will be allowed to edit their SpamAssassin user_prefs file (~/.spamassassin/user_prefs) in openwebmail. enable_pop3 ----------------------------------------------------------------------- OpenWebMail has complete support as pop3 client. If you want to disable pop3 related functions from user, please set this to 'no' pop3_disallowed_servers ----------------------------------------------------------------------- a list of hostnames which we disallow. The host may share the same mailspool, or for some administrative reason be undesirable. pop3_delmail_by_default ----------------------------------------------------------------------- If this option is on, openwebamil will set 'delete remote mail' to yes when creating new record in pop3 book pop3_delmail_hidden ----------------------------------------------------------------------- If this option is on, openwebmail will hide the 'del remote mail' checkbox in editpop3 menu so uer will not be able to change it. Then the value pop3_delmail_by_default will be used pop3_usessl_by_default ----------------------------------------------------------------------- If this option is on, openwebmail will set 'use SSL connection' to yes when creating new record in pop3 book authpop3_server ----------------------------------------------------------------------- When auth_pop3.pl is used as authentication module, this option specify the pop3 server for authentication Default: localhost authpop3_port ----------------------------------------------------------------------- When auth_pop3.pl is used as authentication module, this option specify the port of the pop3 server for authentication Default: 110 authpop3_getmail ----------------------------------------------------------------------- When auth_pop3.pl is used as authentication module, this option makes openwebmail fetch the mails from pop3 auth server after login automatically ps: this option should be set to 'no' if the pop3 authserver is the machine where openwebmail is running to aviod loop. authpop3_delmail ----------------------------------------------------------------------- When auth_pop3.pl is used as authentication module, this option makes openwebmail delete mails from pop3 auth server after they have be fetched authpop3_usessl ----------------------------------------------------------------------- When auth_pop3.pl is used as authentication module, this option makes openwebmail use SSL to connect to auth pop3 server loginerrordelay ----------------------------------------------------------------------- The delay in seconds for the response of a failed login. This is used to protect the system from the password hacking attempt. fetchpop3interval ----------------------------------------------------------------------- If user enables autopop3 in user preference, openwebmail will fetch pop3mail automatically after he login. And this option determines how long openwebmail should check mail on pop3 servers for the user. calendar_email_notifyinterval ----------------------------------------------------------------------- The interval(unit:minute, default 120min) that calendar event will be checked for sending email notification. Set this option to '0' will disable the email notification feature. The notification emails are actually sent by external program openwebmail-tool.pl, sysadm has to put 'openwebmail-tool.pl -n -a -q' in crontab. The frequency specified in crontab must be high enough so that the interval between two execution will be smaller than calendar_email_notifyinterval Example: openwebmail.conf: calendar_email_notifyinterval 120 crontab: 0 */2 * * * /usr/local/www/cgi-bin/openwebmail/openwebmail-tool.pl -n -a -q enable_strictfoldername ----------------------------------------------------------------------- If this option is to yes, any shell escaped character in foldername will be treated as invalid. foldername_maxlen ----------------------------------------------------------------------- This is the maximum length for the name of a folder maxbooksize ----------------------------------------------------------------------- This is the maximum size, in kilobytes, that a user's frombook, filterbook, pop3book or historybook can grow to. This avoids a user filling up your server's hard drive space by spamming garbage book entries. attlimit ----------------------------------------------------------------------- This is the limit on the size of attachments (in KB). Large attachments can significantly drain a server's resources during the encoding process. Note that this affects outgoing attachment size only, and will not prevent users from receiving messages with large attachments. That's up to you in your sendmail configuration. Set this to 0 to disable the limit (not recommended). Some proxy server also has size limit on POST operation, the size of your attachment will also be limited by that abook_maxsizeallbooks ----------------------------------------------------------------------- This is the maximum size, in kilobytes, that all user's addressbooks can grow to. This avoids a user filling up your server's hard drive space by spamming garbage addressbook entries. Set this to 0 to disable the limit (not recommended). abook_globaleditable ----------------------------------------------------------------------- If this option is set to 'yes', then all users will be allowed to edit the global addressbook. If this option is set to 'no', then users will only be allowed read-access to the global addressbook if it is defined. If it is undefined there will be no global addressbook. abook_importlimit ----------------------------------------------------------------------- This limits the size of addressbooks that can be imported (in KB). Set this to 0 to disable the limit (not recommended). abook_attlimit ----------------------------------------------------------------------- This is the limit on the size of addressbook attachment uploads (in KB). This limits the size of photos, sounds, logos, keys, and agents that can be added to contacts. Set this to 0 to disable the limit (not recommended). Some proxy server also has size limit on POST operation, the size of your upload will also be limited by that. enable_ldap_abook ----------------------------------------------------------------------- If this option is set to yes, openwebmail cache LDAP entries to global addressbook ldap_cache. ldap_abook_host ----------------------------------------------------------------------- the LDAP server that provide contact entries ldap_abook_user ----------------------------------------------------------------------- the userid used to access LDAP server ldap_abook_password ----------------------------------------------------------------------- the password of the above userid ldap_abook_base ----------------------------------------------------------------------- the LDAP base DN ldap_abook_container ----------------------------------------------------------------------- it is container relative name if the LDAP tree contains multiple addressbook if this option is set to 'none', then it won't be used at all. ldap_abook_prefix ----------------------------------------------------------------------- the addressbook prefix, eg: ou, cn ... ldap_abook_cachelifetime ----------------------------------------------------------------------- the lifetime of the ldap cache file. (unit: minute) openwebmail will refresh the cached local copy with data on LDAP server if the cached addressbook is older than the time specified here webdisk_rootpath ----------------------------------------------------------------------- This is the additional path under user homedir to be used as the webdisk root directory Example: Assume the user homedir is /home/users/celia, option value celia webdisk root directory ------------ ---------------------------- / /home/users/celia /webdisk /home/users/celia/webdisk webdisk_readonly ----------------------------------------------------------------------- If set this option to yes, the webdisk will become readonly. webdisk_uploadlimit ----------------------------------------------------------------------- This is the limit on the size of upload in web disk (in KB). Set this to 0 to disable the limit (not recommended). Some proxy server also has size limit on POST operation, the size of your upload will also be limited by that webdisk_lsmailfolder ----------------------------------------------------------------------- If this option is set to 'no', the webdisk won't list and won't allow access to the webmail folder directory webdisk_lshidden ----------------------------------------------------------------------- If this option is set to 'no', the webdisk won't list and won't allow access to those directories or files starting with . (dot) webdisk_lsunixspec ----------------------------------------------------------------------- If this option is set to 'no', the webdisk won't list and won't allow access to those directories or files which have special meaning in unix. eg: FIFO, socket, block device, character device webdisk_lssymlink ----------------------------------------------------------------------- If this option is set to 'no', the webdisk won't list and won't allow access to symbolic linked directories or files. webdisk_allow_symlinkcreate ----------------------------------------------------------------------- If this option is set to 'no', then user can not create symlink in the webdisk webdisk_allow_symlinkout ----------------------------------------------------------------------- If this option is set to 'no', then access to symbolic links that points to files outside the webdisk will be prohibited. webdisk_symlinkout_display ----------------------------------------------------------------------- The option detrmines how a symlinkout file is displayed in webdisk. If it is set to 'path', the destinated path is displayed after symlink If it is set to '@', a '@' is displayed after symlink If it is set to 'none', the symlink will looks like regular dir or file webdisk_allow_thumbnail ----------------------------------------------------------------------- If this option is set to 'no', then all thumbnail related function in webdisk will not be available to user ps: This thumbnail is created by the 'convert' utility in the ImageMagick package. The conversion could take times to process on a slow machine. webdisk_allow_untar webdisk_allow_unzip webdisk_allow_unrar webdisk_allow_unarj webdisk_allow_unace webdisk_allow_unlzh ----------------------------------------------------------------------- The default for these options is 'yes', but you may want to disable some of them if your openwebmail users are running in same uid. ps: These programs can do decompression recursively. And we suggest sysadm should at least disable webdisk_allow_untar if the users are running in same uid, since the the user may untar files containing symbolic links to files other than his own. webdisk_allow_chmod ----------------------------------------------------------------------- If this option is set to 'no', the user can not chmod files in webdisk. spool_limit ----------------------------------------------------------------------- Once the size of user INBOX folder meet or exceed this limit (in KB), most write access in webmail will be disabled, except the moving of message from INBOX to other folder until the size of INBOX is under this limit. quota_limit ----------------------------------------------------------------------- Basically, openwebmail will get the use quota usage and quota limit from module defined in option quota_module. However, if quota module doesn't support quota limit (eg:quota_du.pl always return the limit as -1), the value defined in this option will be used as quota limit Once a user's homedir diskusage meet or exceed this size (in KB), most write access in openwebmail will be disabled, except the deletion of messages or files. This option does not prevent the operation taking the user over this limit from completing, it simply inhibits further saving of messages or files until the folder size is brought down again. Set this to 0 to disable the quota limit feature ps: please also refer to option delmail_ifquotahit, delfile_ifquotahit quota_threshold ---------------------------------------------------------------------- If the percentage of the used quota is over this threshold, a '[Usage N%]' will be displayed in the title bar in the folder view. Set this to 0 will make the '[UsageN%]' always appear. delmail_ifquotahit ----------------------------------------------------------------------- If the user quota usage exceeds the option quota_limit and more than 50% quota usage comes from the mail folders, setting this option to 'yes' will make openwebmail remove the oldest messages from the folders automatically. The following steps are used in the message removal: 1. empty mail-trash 2. empty saved-drafts 3. cut other folders cutlist=(sentmail, saved-messages); put userfolders to cutlist if they are more than 33% used folder quota put INBOX to cutlist if it is more than 33% used folder quota remove oldest msgs from folders in cutlist until user quota usage < 90% quota_limit delfile_ifquotahit ----------------------------------------------------------------------- If the user quota usage exceeds the option quota_limit and more than 50% quota usage comes from the webdisk files. setting this option to 'yes' will make openwebmail remove the oldest files from the webdisk / automatically. vdomain_admlist ----------------------------------------------------------------------- Users of virtual domains defined in this option can manage their 'own' domain space without any direct access by ssh or telnet to the server itself. At the current state, a user can only manage the domain accounts of his current logged on e-mail account. For example, admin@foo.bar can manage all e-mail accounts of the domain foo.bar :) Default: sysadm vdomain_maxuser ----------------------------------------------------------------------- The max numbers that is allowed for the virtual domain If set this option to 0, the there will be no limit at all. Default: 100. vdomain_maxalias ----------------------------------------------------------------------- The max number of E-Mail aliases that are allowed for each the virtual domain user. If this option is set to 0, the there will be no aliases allowed. Default: 100. vdomain_vmpop3_pwdpath ----------------------------------------------------------------------- The first part (or prefix) of the path to the sub-directories containing the encrypted password files for each virtual domain. (This is equivalent to the VIRTUAL_PASSWORDS_PATH in vm-pop3d document.) Default: /etc/virtual vdomain_vmpop3_pwdname ----------------------------------------------------------------------- the file name (or suffix) for the virtual domain's password file. (This is equivalent to the VIRTUAL_PASSWORD_FNAME in vm-pop3d document.) Default: passwd ps: the password file for domain DOMAINNAME will be $config{vdomain_vmpop3_pwdpath}/DOMAINNAME/$config{vdomain_vmpop3_pwdname} vdomain_vmpop3_mailpath ----------------------------------------------------------------------- The path to the sub-directories containing the mailboxes for each virtual domain. (This is equivalent to the VIRTUAL_MAILPTH in vm-pop3d document.) Default: /var/spool/virtual ps: the user mailspool fiile for USER@DOMAINANME will be $config{vdomain_vmpop3_mailpath}/DOMAINNAME/USERNAME vdomain_postfix_aliases ----------------------------------------------------------------------- The path of the postfix alias file(s) Default: /etc/postfix/aliases vdomain_postfix_virtual ----------------------------------------------------------------------- The path of the postfix virtual map file(s) Default: /etc/postfix/virtual vdomain_postfix_postalias ----------------------------------------------------------------------- The program used to create index of the postfix alias file Default: /usr/sbin/postalias vdomain_postfix_postmap ----------------------------------------------------------------------- The program used to create index of the postfix virtual map file Default: /usr/sbin/postmap vdomain_mailbox_command ----------------------------------------------------------------------- This option approximates the postfix mailbox_command for virtual users. Normally virtual users are not processed through the normal postfix processes, in particular the postfix mailbox_command does not apply to virtual delivery. If you need to process virtual mail through something like procmail, then use this option to define a delivery command instead of the default mail spool file. The command will be wrapped in double quotes with a pipe symbol and substituted in the alias map for all 'Local Mailbox' virtual users. Virtual users redirected to external mail addresses won't be touched by this option. Several parameters (if found in the command) will be substituted as follows: The virtual user name The virtual domain The virtual user home directory The virtual user spool file For example: If the virtual user 'foo@bar.com' is created as a local mailbox with the following vdomain_mailbox_command option: vdomain_mailbox_command /usr/bin/procmail -Y -m /etc/procmailrcs/virtualrc Then the postfix alias file entry will be created to look like this (quotes included): foo.bar.com: "| vdomain_mailbox_command /usr/bin/procmail -Y -m /etc/procmailrcs/virtualrc bar.com foo" When foo@bar.com receives mail, postfix will pipe the mail into the /user/bin/procmail command with the options '-Y -m /etc/procmailrcs/virtualrc bar.com foo' Default: none - vdomain_mailbox_command isn't used by default localusers ----------------------------------------------------------------------- Users in this list will not use the per site conf files. Normally this is only needed if you mix virtual and real users in your local domain. For example, you may set auth_unix.pl as the authentication module in openwebmail.conf and auth_vdomain.pl as the authentication module in the per site in openwebmail.conf. Users listed here won't use per site conf and thus are authenticated as a real user by the auth_unix.pl module in openwebmail.conf. User not listed here will be authenticated as a vdomain user by the auth_vdomain.pl module in per site conf. Example: localusers user1@mydomain.com, user2@mydomain2.com Default: none - per site conf will be used for all users if it exists mailfooter ----------------------------------------------------------------------- A block of text to be appended at the tail of each outgoing mail, such as a legal statement or advertisement. footer_template_file ----------------------------------------------------------------------- This is the template file that will be used for the footer. header_template_file ----------------------------------------------------------------------- This is the template file that will be used for the header. ############################################################################## # default setting for new user's preference ############################################################################## # # The following options with leading default_ prefix will set the default # values for options in the preference for the firsttime login user, # and the user may override these values in their user preference. # # If you want to have some default not being overridden by user, # Please change the prefix default_ to DEFAULT_ in the openwebmail.conf. # default_locale ----------------------------------------------------------------------- This option specifies which locale openwebmail will use in the case that the user's preferred locale is not defined. The locale is made of a language and character set, such as en_US.UTF-8. The list of available locales can be found by listing the etc/lang directory. If this option is set to 'auto', openwebmail will choose the locale based on the language and character sets that are prefered by the client browser. ps: If you are using Apache 2.0 or higher, don't forget to set 'AddDefaultCharset' to 'off' in httpd.conf default_timeoffset ----------------------------------------------------------------------- This is the default time offset of user timezone from GMT, if you are not using the zoneinfo database (see zonetabfile setting). You can set it to 'auto' or value in the notation [-|+]XXXX. For example, for Taiwan, the offset is +0800. default_timezone ----------------------------------------------------------------------- This is the default timezone user if you are using the zoneinfo database (see zonetabfile setting). Valid settings can be found in your system's zone.tab file (for example, America/Sao_Paulo). default_daylightsaving ----------------------------------------------------------------------- This controls whether openwebmail should add one hour to local time for daylight saving. You can set it to 'auto', 'on' or 'off'. When this option is set to 'auto', the daylight saving will be switched on/off automatcically based on the value of the time and its timezone ps: To make openwebmail timezone/daylightsaving works, the server that runs openwebmail must be set with correct date time. We suggest you runs the ntpdate program in crontab to syncronize the server time with NTP servers on Internet. default_realname ----------------------------------------------------------------------- the default realname for the user. If this option is set to 'auto', the realname will be derived from the authentication system. If this option is set to 'none', then null string will be used. This is primarily used in per user config to set realname for specific user. Example: default_realname Celia Wang default_fromemails ----------------------------------------------------------------------- the default from email addresses for the user. If this option is set to 'auto', the fromemail will be derived from the loginname and the option domainnames. This is primarily used in per user config to set email for specific user. Example: default_fromemails name1@domain1.com, name2@domain2.com default_autoreplysubject ----------------------------------------------------------------------- default subject for auto reply message defaultautoreplytext ----------------------------------------------------------------------- default text for auto reply message default_singature ----------------------------------------------------------------------- default signature for all users default_style ----------------------------------------------------------------------- the default style used for new user please check cgi-bin/openwebmail/etc/styles/ for available styles default_iconset ----------------------------------------------------------------------- the default iconset used for new user please check data/openwebmail/images/iconsets/ for available iconsets default_bgurl ----------------------------------------------------------------------- the default background image used for new user ps: if set this to 'none', a transparent blank background will be used default_bgrepeat ----------------------------------------------------------------------- whether to repeat the background image if set this option to 'no', only one instance of the image will be display in the background default_fontsize ----------------------------------------------------------------------- the default fontsize used for new user, available value: 9pt, 10pt, 11pt, 12px, 13px, 14px default_dateformat ----------------------------------------------------------------------- default date format, available values: mm/dd/yyyy, dd/mm/yyyy, yyyy/mm/dd, mm-dd-yyyy, dd-mm-yyyy, yyyy-mm-dd, mm.dd.yyyy, dd.mm.yyyy, yyyy.mm.dd default_hourformat ----------------------------------------------------------------------- 24 or 12 default_ctrlposition_folderview ----------------------------------------------------------------------- control bar position in the folder list view values: top, bottom default_msgsperpage ----------------------------------------------------------------------- This indicates the maximum number of messages to list at a time. Keep this reasonable to ensure fast load time for slow connection users. default_fieldorder ----------------------------------------------------------------------- the order of message attr fields in folder browsing. Available value: date from subject size date subject from size from subject date size subject from date size default_sort ----------------------------------------------------------------------- default message sorting, available values: date, date_rev, sender, sender_rev, subject, subject_rev, size, size_rev ps: date is oldest first, date_rev is newest first the default value for this option is date_rev default_searchtype ----------------------------------------------------------------------- default search type to show in the pulldown next to the search field available values: from to subject date attfilename header textcontent all if 'from' is selected and the folder is sent-mail, the searchtype will be switched to 'to' automagically as a feature, not a bug default_msgdatetype ----------------------------------------------------------------------- default datetype used for date field in message list values: sentdate or recvdate default_useminisearchicon ----------------------------------------------------------------------- whether to use mini search icon in sender and subject fields in message list default_confirmmsgmovecopy ----------------------------------------------------------------------- display confirm window before message move/copy default_defaultdestination ----------------------------------------------------------------------- The default destination folder for the move/copy dropdown menu in folder view and message read values: saved-messages, mail-trash default_smartdestination ----------------------------------------------------------------------- find the destination folder for a message automatically based on its subject default_viewnextaftermsgmovecopy ----------------------------------------------------------------------- goto next message after a message move/copy/deletion in the message view window default_autopop3 ----------------------------------------------------------------------- If this option is set to yes, openwebmail will fetch pop3 mail for user automatically after the user login default_autopop3wait ----------------------------------------------------------------------- If option autopop3 is set to yes, this wait means how long openwebmail should wait before putting the pop3 fetch process into background default_bgfilterthreshold ----------------------------------------------------------------------- This defines when openwebmail should do mail filtering at background. If this option is set to 0, mail filtering is always done at foreground. If this option is set to equal or more than 1, the mail filtering is put into background only if the number of new messages in INBOX is more than this threshold. default_bgfilterwait ----------------------------------------------------------------------- This defines how long openwebmail should wait for background mail filtering before returning the folder message listing or message content to user ps: Foreground mail filtering guarentees that all messages are checked and filtered before the message list is shown to user, but the user have to wait to see the message list until the filter finishes. On the other hand, background mail filtering returns if the mail filtering is not finished in a certain period of time, but the user may see some spam/virus mails that are actually going to be checked and filtered later by the background mail filter. default_moveoldmsgfrominbox ----------------------------------------------------------------------- if this option is set to yes, old messages in INBOX will be moved into saved-messages at login/logout automatically forced_moveoldmsgfrominbox ----------------------------------------------------------------------- When forced, old msg will be forced to move to SAVED folder at login/logout and the option moveoldmsgfrominbox won't be visible in user preference This is useful for servers with small mail spools. Openwebmail also gets better performance with this option set to yes since this prevents the need of rescanning a large INBOX folder default_ctrlposition_msgread ----------------------------------------------------------------------- control bar position in per message reading values: top, bottom default_headers ----------------------------------------------------------------------- This option controls whether to display all entyies in the message header when user is reading a message values: simple, all default_showhtmlastext ----------------------------------------------------------------------- if set this option to 'yes', all tags in a HTML message will be removed and the message will be displayed as a plain text message. default_showimgaslink ----------------------------------------------------------------------- if set this option to 'yes', the image attachments will be showed as link instead of the image picutre. This is useful for users with slow link of network. default_blockimages ----------------------------------------------------------------------- if set this option to 'yes', all inline images of messages will be blocked. User may choose to unblock messages on a per-message basis. User may choose to unblock all messages via their preferences. Displaying images from remote servers by default allows the sender to track if and when the message was read. This setting helps protect user privacy. default_readwithmsgcharset ----------------------------------------------------------------------- If this option is set to 'yes', openwebmail will display message with the message charset rather than the preference charset by default ps: However, english template will be used to guarantee the user can operate the openwebmail UI no matter what charset the message is default_usefixedfont ----------------------------------------------------------------------- if this option is set to yes, openwebmail will display message txt with fixed width font (courier) instead of proportional width font (Arial). This giver better effect when displaying text tables default_usesmileicon ----------------------------------------------------------------------- if this option is set to yes, all smile symbol :) in a message will be replaced with icons. default_disablejs ----------------------------------------------------------------------- if set this option to 'yes', the java script in in html message will be disabled. This prevents user being hijacked to some web site by eval javascript Please refer to http://www.kb.cert.org/vuls/id/707100 for more information default_disableembcode ----------------------------------------------------------------------- This is used to disable the EMBED, OBJECT and APPLET tags in a message. These tages can be used to load malicious code to user browser. Please refer to http://www.cert.org/advisories/CA-2000-02.html for more information default_disableemblink ----------------------------------------------------------------------- This is used to disable the embedded links in a message. This prevents user email addresses being confirmed by spammer through the embedded links. If this option is set to 'cgionly', only embedded CGIs will be disabled, if this option is set to 'all', all embedded links will be disabled, if this option is set to 'none', all embedded links will be kept untouched. The default setting is 'cgionly'. Please refer to http://www.kb.cert.org/vuls/id/707100 for more information default_sendreceipt ----------------------------------------------------------------------- whether to sent the receipt for a message with the 'confirm reading' request, available value: ask, yes, no default_msgformat ----------------------------------------------------------------------- default format for message Available value: auto, text, html, both default_editcolumns ----------------------------------------------------------------------- default columns for message composing windows default_editrows ----------------------------------------------------------------------- default rows for message composing windows default_sendbuttonposition ----------------------------------------------------------------------- default position of send button in message composing windows values: before, after, both default_reparagraphorigmsg ----------------------------------------------------------------------- reparagraph original message before appending it into the body of reply message default_replywithorigmsg ----------------------------------------------------------------------- whether to append original message into the body of the reply message, available value: at_beginning, at_end, none default_sigbeforeforward ----------------------------------------------------------------------- changes the default behavior from appending the signature after a forwarded message text to before the forwarded message text default_backupsentmsg ----------------------------------------------------------------------- backup outgoing messages to SENT folder default_backupsentoncurrfolder ----------------------------------------------------------------------- backup outgoing messages to current folder, if the current folder is not INBOX or DRAFT default_sendcharset ----------------------------------------------------------------------- whether to convert the message charset to another before sending If this option is set to sameascomposing, then the charset chosen by user in composing widnow will be used for outgoing message available value: sameascomposing or charset listed in iconv.pl default_fscharset ----------------------------------------------------------------------- The default charset used for filenames on file system. If this is set to a supported charset, openwebmail will convert the filename between user preference charset and the fscharset. If this is set to 'none', no conversion will be issued. Please refer to modules/lang.pl for supported charsets. ps: It is highly recommended to set this option to the most frequently used charset on the filesystem, which would allow openwebmail to always interpret the filename correctly when the user switches between different charsets. default_uselightbar ----------------------------------------------------------------------- whether to use the light bar for selection default_regexmatch ----------------------------------------------------------------------- if set this option to 'yes', the regular expression is assumed when doing keyword match in search and filterrule. default_hideinternal ----------------------------------------------------------------------- If this option is enabled, internal messages used by POP3 or IMAP server will be hidden from users default_categorizedfolders default_categorizedfolders_fs ----------------------------------------------------------------------- If this option is enabled, the foldernames listed in folders menu will be categroized by their prefix, which is the string in foldername before categorizedfolders_fs (fs means field separator) default_refreshinterval ----------------------------------------------------------------------- This is the default interval in minutes that openwebmail will refresh the screen when the user is listing a folder or reading a message. It gives the openwebmail a chance to check the new mail status. Setting value too small for this option will make your server busy in serving client's request min_refreshinterval ----------------------------------------------------------------------- the minimun value for option refreshinterval This is used to protect your server from being too busy due to a very small refreshinterval setting default_newmailsound ----------------------------------------------------------------------- this is the sound file played if new mail is found. Openwebmail checks new mail for user every 15 min if user is in INBOX folderview. Set to 'NONE' will disable this feature default_newmailwindowtime ----------------------------------------------------------------------- this is the remaining time of the new mail notification window. If it is set to value larger than 0, openwebmail will popup a window to notify the user about the newly incoming messages default_mailsentwindowtime ----------------------------------------------------------------------- this is the remaining time of the mail sent notification window. If it is set to value larger than 0, openwebmail will popup a window to notify the user after a successful message sending. default_dictionary ----------------------------------------------------------------------- the default dictionary used in spellcheck for new user default_trashreserveddays ----------------------------------------------------------------------- message in trash will be deleted if its day age is more than this value, 0 means "delete at logout", 999999 means "never delete" default_spamvirusreserveddays ----------------------------------------------------------------------- message in spam and virus folder will be deleted if its day age is more than this value, 0 means "delete at logout", 999999 means "never delete" default_sessiontimeout ----------------------------------------------------------------------- This indicates how many minutes of inactivity pass before the user session is considered timed out, and the user needs to log in again. Make sure this is big enough that a user typing a long message won't get timeouted while typing! default_viruscheck_source ----------------------------------------------------------------------- the option specifies the mails to be checked by virus check program available value: all, pop3 all - all incoming messages will be checked for virus pop3 - only messages fetched from pop3 servers will be checked for virus ps: this option sets the default source of viruscheck for user, but the actual sources user can choose is limited by the option viruscheck_source_allowed default_viruscheck_maxsize ----------------------------------------------------------------------- To eliminate system load, messages larger than this size won't be passed to virus check program (in KB) default_viruscheck_minbodysize ----------------------------------------------------------------------- To eliminate system load, messages whose body size is smaller than this threshold won't be passed to virus check program (in KB) default_spamcheck_source ----------------------------------------------------------------------- the option specifies which messages will be checked by spam check program available values: all, pop3, none all - all incoming messages will be checked for spam pop3 - only messages fetched from pop3 servers will be checked for spam none - no messages will be checked for spam ps: this option sets the default source of spamcheck for user, but the actual sources user can choose is limited by the option spamcheck_source_allowed default_spamcheck_maxsize ----------------------------------------------------------------------- To eliminate system load, messages larger than this size won't be passed to spam check program (in KB) default_spamcheck_threshold ----------------------------------------------------------------------- spam check program is assumed to return a spam level of a message and messages with spam level equal or larger than this threshold will be treated as spam default_filter_repeatlimit ----------------------------------------------------------------------- Messages in INBOX with same subject from same people will be treated as repeated messages. If repeated count is more than this value, messages will be moved to mail-trash folder. Set this value to 0 will disable this feature. default_filter_badaddrformat ----------------------------------------------------------------------- A email will be treated as bad format in the following cases: 1. from email started with digits 2. from email containing both digits and dot (.) 3. from email containing characters other than alphabat, digits dot(.), dash(-), underline(_) 4. to email containing undisclosed-recipients and any email address Messages with bad email address are normally from spammers. If this option is set to 'yes', these messages will be moved to mail-trash. default_filter_fakedsmtp ----------------------------------------------------------------------- We call a message 'fakedsmtp' if 1.the message from sender to receiver passes through one or more SMTP relays and the first SMTP relay has a invalid hostname. 2.The message is delivered from sender to receiver directly and the sender has invalid hostname. Messages in above cases are normally from spammers. When this option is set to 'yes', these fakedsmtp messages will be moved to mail-trash. default_filter_fakedfrom ----------------------------------------------------------------------- We call a message 'fakedfrom' if the email in From: field is different than the email address in the SMTP envelope. Messages of this type are usually sent from a virus. When this option is set to 'yes', these message will be moved to mail-trash. default_filter_fakedexecontenttype ----------------------------------------------------------------------- If an executable attachment has content-type other than 'application/octet-stream', ex: audio/wav, audio/midi, it may be download and executed automatically on some browser. Messages with such attachments are normally virus mail. When this option is set to 'yes', these messages will be moved to mail-trash. default_abook_width ----------------------------------------------------------------------- default width (in pixels) of the addressbook popup window. The value "max" let the browser use the max width available on screen default_abook_height ----------------------------------------------------------------------- default height (in pixels) of the addressbook popup window. The value "max" let the browser use the max width available on screen default_abook_buttonposition ----------------------------------------------------------------------- default position of continue and cancel buttons in addresbook popup window values: before, after, both default_abook_defaultfilter ----------------------------------------------------------------------- enable or disable default filter in addressbook popup window. values: yes, no default_abook_defaultsearchtype ----------------------------------------------------------------------- field for default filter in addressbook popup window. values: none, name, email, note, all default_abook_defaultkeyword ----------------------------------------------------------------------- text for the default filter in addressbook popup window. default_abook_addrperpage ----------------------------------------------------------------------- default number of addresses to display per page when displaying addressbooks. default_abook_collapse ----------------------------------------------------------------------- display addresses in collapsed mode (one line of information per contact) or in expanded mode (all lines of information per contact). Some contacts will have many phone numbers or many email addresses for example. default_abook_listviewfieldorder ----------------------------------------------------------------------- default field order (the columns) in the addressbook listview. This is a COMMA SEPARATED list. Only 5 columns are currently supported, so any values after the 5th value are ignored. Values can be any of: fullname prefix first middle last suffix email phone note none For example: first,last,email,none,none default_abook_sort ----------------------------------------------------------------------- default addressbook sorting. Available values: fullname fullname_rev prefix prefix_rev first first_rev middle middle_rev last last_rev suffix suffix_rev email email_rev phone phone_rev default_calendar_defaultview ----------------------------------------------------------------------- the default view to use when user clicks the calendar button Valid values: calyear, calmonth, calweek, calday, callist default_calendar_holidaydef ----------------------------------------------------------------------- the default holiday definition file to use. This should be set to a locale such as 'en_US.UTF-8'. If this option is set to auto, then the definition file will be chosen based on the users locale preference setting. If this option is set to none, then no holiday definition file will be used. default_calendar_showlunar ----------------------------------------------------------------------- show lunar calendar dates when viewing calendars. Lunar calendars are used for holidays and traditional events by many countries including China, Singapore, Japan, Thailand, and Korea. default_calendar_monthviewnumitems ----------------------------------------------------------------------- the number of items will be showed for each day in the month view This should probably be between 3 and 6 default_calendar_weekstart ----------------------------------------------------------------------- The start day of a week. 0 for Sunday, 1 for Monday, ..., 6 for Saturday default_calendar_starthour default_calendar_endhour ----------------------------------------------------------------------- The start and end time of the calendar dayview, it should be in military hours (no minutes!) Shoud be between 0000 and 2400 inclusive. default_calendar_interval ----------------------------------------------------------------------- The interval of each time slot in the dayview (in minute). Valid value: 5, 10, 15, 20, 30 or 60 default_calendar_showemptyhours ----------------------------------------------------------------------- set this to 'yes' if we want to show hours that have no entries for them in the calendar dayview. default_calendar_reminderdays ----------------------------------------------------------------------- The days that the reminder tries to look ahead for upcoming events default_calendar_reminderforglobal ----------------------------------------------------------------------- set this to 'yes' if you want the reminder to checks for events in global calendar default_webdisk_dirnumitems ----------------------------------------------------------------------- the number of items will be showed for dir list in webdisk default_webdisk_confirmmovecopy ----------------------------------------------------------------------- display confirm window before directory/file move/copy in webdisk default_webdisk_confirmdel ----------------------------------------------------------------------- display confirm window before directory/file deletion in webdisk default_webdisk_confirmcompress ----------------------------------------------------------------------- display confirm window before directory/file compression (zip, tgz, gzip) in webdisk default_webdisk_fileeditcolumns ----------------------------------------------------------------------- default columns for file edit windows in webdisk default_webdisk_fileeditrows ----------------------------------------------------------------------- default rows for file edit windows in webdisk