* Default SquirrelMail configuration file
* BEFORE EDITING THIS FILE!
* Don't edit this file directly. Copy it to config.php before you
* edit it. However, it is best to use the configuration script
* conf.pl if at all possible. That is the easiest and cleanest way
* Note on SECURITY: some options require putting a password in this file.
* Please make sure that you adapt its permissions appropriately to avoid
* passwords being leaked to e.g. other system users. Take extra care when
* the webserver is shared with untrusted users.
* @copyright 2000-2011 The SquirrelMail Project Team
* @license http://opensource.org/licenses/gpl-license.php GNU Public License
* @version $Id: config_default.php 14084 2011-01-06 02:44:03Z pdontthink $
/* Do not change this value. */
$config_version = '1.4.0';
/*** Organization preferences ***/
* @global string $org_name
$org_name = "[[site_name]]";
* Organization's logo picture (blank if none)
* @global string $org_logo
$org_logo = SM_PATH . 'images/sm_logo.png';
* The width of the logo (0 for default)
* @global string $org_logo_width
* The height of the logo (0 for default)
* @global string $org_logo_height
$org_logo_height = '111';
* This is the web page title that appears at the top of the browser window.
* @global string $org_title
$org_title = "SquirrelMail $version";
* Rather than going to the signout.php page (which only allows you
* to sign back in), setting signout_page allows you to sign the user
* out and then redirect to whatever page you want. For instance,
* the following would return the user to your home page:
* Set to the empty string to continue to use the default signout page.
* @global string $signout_page
* By default SquirrelMail takes up the whole browser window,
* this allows you to embed it within sites using frames. Set
* this to the frame you want it to stay in.
* @global string $frame_top
* Here you can set name of the link displayed on the right side of main page.
* Link will be displayed only if you have $hide_sm_attributions
* @global string $provider_name
$provider_name = 'SquirrelMail';
* Here you can set URL of the link displayed on the right side of main page.
* Link will be displayed only if you have $hide_sm_attributions
* @global string $provider_uri
$provider_uri = 'http://squirrelmail.org/';
/*** Server Settings ***/
* The domain part of local email addresses.
* This is for all messages sent out from this server.
* Reply address is generated by $username@$domain
* Example: In bob@example.com, example.com is the domain.
* If you are running on a machine that doesn't have the tm_gmtoff
* value in your time structure and if you are in a time zone that
* has a negative offset, you need to set this value to 1. This is
* typically people in the US that are running Solaris 7.
* @global bool $invert_time
* What should be used when sending email.
* If it is set to false, SquirrelMail will use SMTP server settings.
* If it is set to true, SquirrelMail will use program defined in
* @global bool $useSendmail
* Your SMTP server (usually the same as the IMAP server).
* @global string $smtpServerAddress
$smtpServerAddress = '[[smtp]]';
* Your SMTP port number (usually 25).
* @global integer $smtpPort
$smtpPort = [[smtp_port]];
* SquirrelMail header encryption
* Encryption key allows to hide SquirrelMail Received: headers
* in outbound messages. Interface uses encryption key to encode
* username, remote address and proxied address, then stores encoded
* information in X-Squirrel-* headers.
* Warning: used encryption function is not bulletproof. When used
* with static encryption keys, it provides only minimal security
* measures and information can be decoded quickly.
* Encoded information can be decoded with decrypt_headers.php script
* from SquirrelMail contrib/ directory.
* @global string $encode_header_key
* Program that should be used when sending email. SquirrelMail expects that
* this program will follow options used by original sendmail
* (http://www.sendmail.org).
* @global string $sendmail_path
$sendmail_path = '/usr/sbin/sendmail';
* Extra sendmail command arguments.
* Sets additional sendmail command arguments. Make sure that arguments are
* supported by your sendmail program. -f argument is added automatically by
* SquirrelMail scripts. Variable defaults to standard /usr/sbin/sendmail
* arguments. If you use qmail-inject, nbsmtp or any other sendmail wrapper,
* which does not support -t and -i arguments, set variable to empty string
* or use arguments suitable for your mailer.
* @global string $sendmail_args
$sendmail_args = '-i -t';
* The dns name (or IP address) for your imap server.
* @global string $imapServerAddress
$imapServerAddress = '[[imap]]';
* Port used by your imap server. (Usually 143)
* @global integer $imapPort
$imapPort = [[imap_port]];
* The type of IMAP server you are running.
* Valid type are the following (case is important):
* Please note that this changes only some of server settings.
* In order to set everything correctly, you need to adjust several
* squirrelmail options. These options are listed in doc/presets.txt
* @global string $imap_server_type
$imap_server_type = 'other';
* Advanced IMAP authentication options control
* CRAM-MD5, DIGEST-MD5, Plain, and TLS
* Set reasonable defaults - you'd never know this was there unless you ask for it
* @global bool $use_imap_tls
$use_imap_tls = [[imap_tls]];
* Advanced SMTP authentication options control
* CRAM-MD5, DIGEST-MD5, Plain, and TLS
* Set reasonable defaults - you'd never know this was there unless you ask for it
* @global bool $use_smtp_tls
$use_smtp_tls = [[smtp_tls]];
* SMTP authentication mechanism
* auth_mech can be either 'none', 'login','plain', 'cram-md5', or 'digest-md5'
* @global string $smtp_auth_mech
$smtp_auth_mech = 'none';
* Custom SMTP Authentication Username
* IMAP username is used if variable is set to an empty string. Variable is included in
* the main configuration file only in 1.4.11+ and 1.5.2+.
* @global string $smtp_sitewide_user
$smtp_sitewide_user = '';
* Custom SMTP Authentication Password
* IMAP password is used if variable is set to an empty string. Variable is included in
* the main configuration file in 1.4.11+ and 1.5.2+
* @global string $smtp_sitewide_pass
$smtp_sitewide_pass = '';
* IMAP authentication mechanism
* auth_mech can be either 'login','plain', 'cram-md5', or 'digest-md5'
* @global string $imap_auth_mech
$imap_auth_mech = 'login';
* This is the delimiter that your IMAP server uses to distinguish between
* folders. For example, Cyrus uses '.' as the delimiter and a complete
* folder would look like 'INBOX.Friends.Bob', while UW uses '/' and would
* look like 'INBOX/Friends/Bob'. Normally this should be left at 'detect'
* but if you are sure you know what delimiter your server uses, you can
* To have it autodetect the delimiter, set it to 'detect'.
* @global string $optional_delimiter
$optional_delimiter = 'detect';
* POP before SMTP setting
* Do you wish to use POP3 before SMTP? Your server must
* support this in order for SquirrelMail to work with it.
* @global bool $pop_before_smtp
$pop_before_smtp = false;
* POP before SMTP server address
* When using POP3 before SMTP, if the POP server address is
* not the same as the SMTP server address, specify it here.
* If this is left empty, the SMTP server address will be
* @global bool $pop_before_smtp_host
$pop_before_smtp_host = '';
/*** Folder Settings ***/
* Default IMAP folder prefix
* Many servers store mail in your home directory. With this, they
* store them in a subdirectory: mail/ or Mail/, etc. If your server
* does this, please set this to what the default mail folder should
* be. This is still a user preference, so they can change it if it
* is different for each user.
* $default_folder_prefix = 'mail/';
* $default_folder_prefix = 'Mail/folders/';
* If you do not use this, set it to the empty string.
* @global string $default_folder_prefix
$default_folder_prefix = '';
* User level prefix control
* If you do not wish to give them the option to change this, set it
* to false. Otherwise, if it is true, they can change the folder prefix
* @global bool $show_prefix_option
$show_prefix_option = false;
* The following are related to deleting messages.
* If this is set to 'true', when 'delete' is pressed, it
* will attempt to move the selected messages to the folder
* named $trash_folder. If it's set to 'false', we won't even
* attempt to move the messages, just delete them.
* If this is set to 'true', sent messages will be stored in
* $sent_folder by default.
* If this is set to 'true', users are able to use $draft_folder
* to store their unfinished messages.
* This is the path to the default trash folder. For Cyrus
* IMAP, it would be 'INBOX.Trash', but for UW it would be
* 'Trash'. We need the full path name here.
* This is the patch to where Draft messages will be stored.
* If this is true, when a message is moved or copied, the
* source mailbox will get expunged, removing all messages
* This is the path to where Sent messages will be stored.
* If this is true, when a folder is deleted then it will
* not get moved into the Trash folder.
* @global bool $default_move_to_trash
* @global bool $default_move_to_sent
* @global bool $default_save_as_draft
* @global string $trash_folder
* @global string $sent_folder
* @global string $draft_folder
* @global bool $auto_expunge
* @global bool $delete_folder
$default_move_to_trash = true;
$default_move_to_sent = true;
$default_save_as_draft = true;
$trash_folder = 'INBOX.Trash';
$sent_folder = 'INBOX.Sent';
$draft_folder = 'INBOX.Drafts';
* Special Folder Color Control
* Whether or not to use a special color for special folders. If not,
* special folders will be the same color as the other folders.
* @global bool $use_special_folder_color
$use_special_folder_color = true;
* Create Special Folders Control
* Should I create the Sent and Trash folders automatically for
* a new user that doesn't already have them created?
* @global bool $auto_create_special
$auto_create_special = true;
* List Special Folders First Control
* Whether or not to list the special folders first (true/false).
* @global bool $list_special_folders_first
$list_special_folders_first = true;
* Subfolder Layout Control
* Are all your folders subfolders of INBOX (i.e. cyrus IMAP server).
* If you are unsure, set it to false.
* @global bool $default_sub_of_inbox
$default_sub_of_inbox = true;
* Subfolder Format Control
* Some IMAP daemons (UW) handle folders weird. They only allow a
* folder to contain either messages or other folders, not both at
* the same time. This option controls whether or not to display an
* option during folder creation. The option toggles which type of
* If this option confuses you, just set it to 'true'. You can not hurt
* anything if it's true, but some servers will respond weird if it's
* false. (Cyrus works fine whether it's true OR false).
* @global bool $show_contain_subfolders_option
$show_contain_subfolders_option = false;
* These next two options set the defaults for the way that the
* users see their folder list.
* Specifies whether or not the users will see the number of
* unseen in each folder by default and also which folders to
* do this to. Valid values are: 1=none, 2=inbox, 3=all.
* Specifies the type of notification to give the users by
* default. Valid choice are: 1=(4), 2=(4,25).
* @global integer $default_unseen_notify
* @global integer $default_unseen_type
$default_unseen_notify = 2;
$default_unseen_type = 1;
* This enables the no select fix for Cyrus when subfolders
* exist but parent folders do not
* @global bool $noselect_fix_enable
$noselect_fix_enable = false;
/*** General options ***/
* Path to the data/ directory
* It is a possible security hole to have a writable directory
* under the web server's root directory (ex: /home/httpd/html).
* It is possible to put the data directory anywhere you would like;
* it is strongly advised that it is NOT directly web-accessible.
* The path name can be absolute or relative (to the config directory).
* If it is relative, it must use the SM_PATH constant.
* $data_dir = '/var/local/squirrelmail/data/';
* Relative (to main SM directory):
* $data_dir = SM_PATH . 'data/';
* (NOT recommended: you need to secure apache to make sure these
* files are not world readable)
* @global string $data_dir
$data_dir = '[[softpath]]/data/';