ExpressionEngine Configuration Variables

as of EE v2.5.3 - Build Date: 20120911

This aims to be the definitive resource for the EE configuration variable overrides that you can use to modify your ExpressionEngine installation in /system/expressionengine/config/config.php. To get a list of all the available configuration variables, put print_r($this->EE->config->config); on a PHP-enabled template. There are also a number of Hidden Configuration Variables, which you can read about in the ExpressionEngine docs.

If you have any tips, tricks, or information around any of the variables, please send them to us for inclusion here, so we can benefit the entire EE community.

/*
|--------------------------------------------------------------------------
| ExpressionEngine Config Items
|--------------------------------------------------------------------------
|
| The following items are for use with ExpressionEngine.  The rest of
| the config items are for use with CodeIgniter, some of which are not
| observed by ExpressionEngine, e.g. 'permitted_uri_chars'
|
*/

$config['app_version'] = '253';
$config['install_lock'] = "";
$config['license_number'] = '';
$config['debug'] = '1';
$config['cp_url'] = 'http://site.com/system/index.php';
$config['doc_url'] = 'http://expressionengine.com/user_guide/';
$config['is_system_on'] = 'y';
$config['allow_extensions'] = 'y';
$config['site_label'] = 'Site Name';
$config['cookie_prefix'] = '';



/*
|--------------------------------------------------------------------------
| CodeIgniter Config Items
|--------------------------------------------------------------------------
*/

$config['admin_session_type'] = 'cs';
$config['allow_avatar_uploads'] = 'n';
$config['allow_dictionary_pw'] = 'y';
$config['allow_member_localization'] = 'n';
$config['allow_member_registration'] = 'y';
$config['allow_multi_emails'] = 'n';
$config['allow_multi_logins'] = 'y';
$config['allow_signatures'] = 'y';
$config['allow_username_change'] = 'y';
$config['auto_assign_cat_parents'] = 'y';
$config['auto_convert_high_ascii'] = 'y';
$config['autosave_interval_seconds'] = '0';
$config['avatar_max_height'] = '100';
$config['avatar_max_kb'] = '50';
$config['avatar_max_width'] = '100';
$config['avatar_path'] = '/path/images/avatars/';
$config['avatar_url'] = 'http://site.com/images/avatars/';
$config['ban_action'] = 'restrict';
$config['ban_destination'] = 'http://www.yahoo.com/';
$config['ban_message'] = 'This site is currently unavailable';
$config['banish_masked_ips'] = 'y';
$config['banishment_message'] = 'You have exceeded the allowed page load frequency.';
$config['banishment_type'] = 'message';
$config['banishment_url'] = '';
$config['banned_emails'] = '';
$config['banned_ips'] = '';
$config['banned_screen_names'] = '';
$config['banned_usernames'] = '';

/*
|--------------------------------------------------------------------------
| Base Site URL
|--------------------------------------------------------------------------
|
| URL to your CodeIgniter root. Typically this will be your base URL,
| WITH a trailing slash:
|
| http://example.com/
|
*/
$config['base_url'] = 'http://site.com/';

/*
|--------------------------------------------------------------------------
| Cache Directory Path
|--------------------------------------------------------------------------
|
| Leave this BLANK unless you would like to set something other than the default
| system/cache/ folder.  Use a full server path with trailing slash.
|
*/
$config['cache_path'] = '';

$config['captcha_font'] = 'y';
$config['captcha_path'] = '/path/images/captchas/';
$config['captcha_rand'] = 'y';
$config['captcha_require_members'] = 'n';
$config['captcha_url'] = 'http://site.com/images/captchas/';
$config['censor_replacement'] = '';
$config['censored_words'] = '';
$config['channel_nomenclature'] = 'channel';

/*
|--------------------------------------------------------------------------
| Default Character Set
|--------------------------------------------------------------------------
|
| This determines which character set is used by default in various methods
| that require a character set to be provided.
|
*/
$config['charset'] = 'UTF-8';

/*
|--------------------------------------------------------------------------
| Output Compression
|--------------------------------------------------------------------------
|
| Enables Gzip output compression for faster page loads.  When enabled,
| the output class will test whether your server supports Gzip.
| Even if it does, however, not all browsers support compression
| so enable only if you are reasonably sure your visitors can handle it.
|
| VERY IMPORTANT:  If you are getting a blank page when compression is enabled it
| means you are prematurely outputting something to your browser. It could
| even be a line of whitespace at the end of one of your scripts.  For
| compression to work, nothing can be sent before the output buffer is called
| by the output class.  Do not "echo" any values with compression enabled.
|
*/
$config['compress_output'] = FALSE;

$config['controller_trigger'] = 'C';
$config['cookie_domain'] = '';
$config['cookie_path'] = '';
$config['cp_theme'] = 'default';


/*
|--------------------------------------------------------------------------
| CSRF Protection
|--------------------------------------------------------------------------
|
| Determines whether Cross Site Request Forgery protection is enabled.
| For more info visit the security library page of the user guide
|
*/
$config['csrf_protection'] = FALSE;

$config['daylight_savings'] = 'y';
$config['default_member_group'] = '5';
$config['default_site_dst'] = '';
$config['default_site_timezone'] = '';
$config['deft_lang'] = 'english';
$config['deny_duplicate_data'] = 'y';
$config['directory_trigger'] = 'D';
$config['disable_all_tracking'] = 'y';
$config['email_batch_size'] = '';
$config['email_batchmode'] = 'n';
$config['email_charset'] = 'utf-8';
$config['email_console_timelock'] = '5';
$config['email_debug'] = 'n';
$config['email_module_captchas'] = 'n';
$config['emoticon_path'] = 'http://site.com/images/smileys/';
$config['emoticon_url'] = 'http://site.com/images/smileys/';
$config['enable_avatars'] = 'y';
$config['enable_censoring'] = 'n';
$config['enable_db_caching'] = 'n';
$config['enable_emoticons'] = 'y';
$config['enable_entry_view_tracking'] = 'n';
$config['enable_hit_tracking'] = 'n';


/*
|--------------------------------------------------------------------------
| Enable/Disable System Hooks
|--------------------------------------------------------------------------
|
| If you would like to use the "hooks" feature you must enable it by
| setting this variable to TRUE (boolean).  See the user guide for details.
|
*/
$config['enable_hooks'] = TRUE;

$config['enable_online_user_tracking'] = 'n';
$config['enable_photos'] = 'n';

/*
|--------------------------------------------------------------------------
| Enable Query Strings
|--------------------------------------------------------------------------
|
| By default CodeIgniter uses search-engine friendly segment based URLs:
| example.com/who/what/where/
|
| You can optionally enable standard query string based URLs:
| example.com?who=me&what=something&where=here
|
| Options are: TRUE or FALSE (boolean)
|
| The two other items let you set the query string "words" that will
| invoke your controllers and its functions:
| example.com/index.php?c=controller&m=function
|
| Please note that some of the helpers won't work as expected when
| this feature is enabled, since CodeIgniter is designed primarily to
| use segment based URLs.
|
*/
$config['enable_query_strings'] = FALSE;

$config['enable_search_log'] = 'y';
$config['enable_sql_caching'] = 'n';
$config['enable_throttling'] = 'n';

/*
|--------------------------------------------------------------------------
| Encryption Key
|--------------------------------------------------------------------------
|
| If you use the Encryption class or the Sessions class with encryption
| enabled you MUST set an encryption key.  See the user guide for info.
|
*/
$config['encryption_key'] = '';

$config['force_query_string'] = 'n';
$config['function_trigger'] = 'M';

/*
|--------------------------------------------------------------------------
| Global XSS Filtering
|--------------------------------------------------------------------------
|
| Determines whether the XSS filter is always active when GET, POST or
| COOKIE data is encountered
|
*/
$config['global_xss_filtering'] = '';

$config['gzip_output'] = 'n';
$config['hidden_template_indicator'] = '_';
$config['honor_entry_dst'] = 'y';
$config['image_library_path'] = '';
$config['image_resize_protocol'] = 'gd2';
$config['include_seconds'] = 'n';

/*
|--------------------------------------------------------------------------
| Index File
|--------------------------------------------------------------------------
|
| Typically this will be your index.php file, unless you've renamed it to
| something else. If you are using mod_rewrite to remove the page set this
| variable so that it is blank.
|
*/
$config['index_page'] = '';

$config['is_site_on'] = 'y'; // easy way to disable your site

/*
|--------------------------------------------------------------------------
| Default Language
|--------------------------------------------------------------------------
|
| This determines which set of language files should be used. Make sure
| there is an available translation if you intend to use something other
| than english.
|
*/
$config['language'] = 'english';

$config['lockout_time'] = '30';

/*
|--------------------------------------------------------------------------
| Date Format for Logs
|--------------------------------------------------------------------------
|
| Each item that is logged has an associated date. You can use PHP date
| codes to set your own date formatting
|
*/
$config['log_date_format'] = 'Y-m-d H:i:s';

$config['log_email_console_msgs'] = 'y';

/*
|--------------------------------------------------------------------------
| Error Logging Directory Path
|--------------------------------------------------------------------------
|
| Leave this BLANK unless you would like to set something other than the default
| system/logs/ folder.  Use a full server path with trailing slash.
|
*/
$config['log_path'] = '';

$config['log_referrers'] = 'n';
$config['log_search_terms'] = 'y';

/*
|--------------------------------------------------------------------------
| Error Logging Threshold
|--------------------------------------------------------------------------
|
| If you have enabled error logging, you can set an error threshold to
| determine what gets logged. Threshold options are:
|
| 0 = Disables logging, Error logging TURNED OFF
| 1 = Error Messages (including PHP errors)
| 2 = Debug Messages
| 3 = Informational Messages
| 4 = All Messages
|
| For a live site you'll usually only enable Errors (1) to be logged otherwise
| your log files will fill up very fast.
|
*/
$config['log_threshold'] = 0;

$config['mail_format'] = 'plain';
$config['mail_protocol'] = '';
$config['mailinglist_enabled'] = 'y';
$config['mailinglist_notify'] = 'n';
$config['mailinglist_notify_emails'] = '';
$config['max_caches'] = '150';
$config['max_logged_searches'] = '500';
$config['max_page_loads'] = '10';
$config['max_referrers'] = '500';
$config['max_tmpl_revisions'] = '5';
$config['mbr_notification_emails'] = '';
$config['member_theme'] = 'default';
$config['memberlist_order_by'] = 'total_posts';
$config['memberlist_row_limit'] = '20';
$config['memberlist_sort_order'] = 'desc';
$config['name_of_dictionary_file'] = '';
$config['new_member_notification'] = 'n';
$config['new_posts_clear_caches'] = 'y';
$config['new_version_check'] = 'y';
$config['output_charset'] = 'utf-8';
$config['password_lockout'] = 'y';
$config['password_lockout_interval'] = '1';

/*
|--------------------------------------------------------------------------
| Allowed URL Characters
|--------------------------------------------------------------------------
|
| This lets you specify which characters are permitted within your URLs.
| When someone tries to submit a URL with disallowed characters they will
| get a warning message.
|
| As a security measure you are STRONGLY encouraged to restrict URLs to
| as few characters as possible.  By default only these are allowed: a-z 0-9~%.:_-
|
| Leave blank to allow all characters -- but only if you are insane.
|
| DO NOT CHANGE THIS UNLESS YOU FULLY UNDERSTAND THE REPERCUSSIONS!!
|
*/
$config['permitted_uri_chars'] = 'a-z 0-9~%.:_\\-';

$config['photo_max_height'] = '100';
$config['photo_max_kb'] = '50';
$config['photo_max_width'] = '100';
$config['photo_path'] = '/path/images/member_photos/';
$config['photo_url'] = 'http://site.com/images/member_photos/';
$config['profile_trigger'] = 'asdflhasdfmnaasdgasfgl87asdg';
$config['protect_javascript'] = 'n';

/*
|--------------------------------------------------------------------------
| Reverse Proxy IPs
|--------------------------------------------------------------------------
|
| If your server is behind a reverse proxy, you must whitelist the proxy IP
| addresses from which CodeIgniter should trust the HTTP_X_FORWARDED_FOR
| header in order to properly identify the visitor's IP address.
| Comma-delimited, e.g. '10.0.1.200,10.0.1.201'
|
*/
$config['proxy_ips'] = '';

$config['prv_msg_attach_maxsize'] = '250';
$config['prv_msg_attach_total'] = '100';
$config['prv_msg_auto_links'] = 'y';
$config['prv_msg_html_format'] = 'safe';
$config['prv_msg_max_attachments'] = '3';
$config['prv_msg_max_chars'] = '6000';
$config['prv_msg_upload_path'] = '';
$config['pw_min_len'] = '5';
$config['recount_batch_total'] = '1000';
$config['redirect_method'] = 'redirect';
$config['redirect_submitted_links'] = 'n';
$config['req_mbr_activation'] = 'none';
$config['require_ip_for_login'] = 'y';
$config['require_ip_for_posting'] = 'y';
$config['require_secure_passwords'] = 'n';
$config['require_terms_of_service'] = 'y';
$config['reserved_category_word'] = 'category';

/*
|--------------------------------------------------------------------------
| Rewrite PHP Short Tags
|--------------------------------------------------------------------------
|
| If your PHP installation does not have short tag support enabled CI
| can rewrite the tags on-the-fly, enabling you to utilize that syntax
| in your view files.  Options are TRUE or FALSE (boolean)
|
*/
$config['rewrite_short_tags'] = TRUE;

$config['save_tmpl_files'] = 'y';
$config['save_tmpl_revisions'] = 'n';
$config['secure_forms'] = 'y';
$config['send_headers'] = 'y';
$config['server_offset'] = '';
$config['server_timezone'] = 'UM5';
$config['show_profiler'] = 'y';
$config['sig_allow_img_hotlink'] = 'n';
$config['sig_allow_img_upload'] = 'n';
$config['sig_img_max_height'] = '80';
$config['sig_img_max_kb'] = '30';
$config['sig_img_max_width'] = '480';
$config['sig_img_path'] = '';
$config['sig_img_url'] = '';
$config['sig_maxlength'] = '500';
$config['site_404'] = 'site/404';
$config['site_description'] = '';
$config['site_id'] = '1';
$config['site_index'] = '';

$config['site_name'] = '';
$config['site_short_name'] = 'default_site';
$config['site_url'] = 'http://site.com/';
$config['smtp_password'] = '';
$config['smtp_server'] = '';
$config['smtp_username'] = '';
$config['strict_urls'] = 'n';


/*
|--------------------------------------------------------------------------
| Class Extension Prefix
|--------------------------------------------------------------------------
|
| This item allows you to set the filename/classname prefix when extending
| native libraries.  For more information please see the user guide:
|
| http://codeigniter.com/user_guide/general/core_classes.html
| http://codeigniter.com/user_guide/general/creating_libraries.html
|
*/
$config['subclass_prefix'] = 'EE_';

$config['template_debugging'] = 'y';
$config['theme_folder_path'] = '/path/themes/';
$config['theme_folder_url'] = 'http://site.com/themes/';
$config['thumbnail_prefix'] = 'thumb';
$config['time_format'] = 'us';
$config['time_interval'] = '8';

/*
|--------------------------------------------------------------------------
| Master Time Reference
|--------------------------------------------------------------------------
|
| Options are "local" or "gmt".  This pref tells the system whether to use
| your server's local time as the master "now" reference, or convert it to
| GMT.  See the "date helper" page of the user guide for information
| regarding date handling.
|
*/
$config['time_reference'] = 'local';

$config['tmpl_file_basepath'] = '';
$config['un_min_len'] = '4';

/*
|--------------------------------------------------------------------------
| URI PROTOCOL
|--------------------------------------------------------------------------
|
| This item determines which server global should be used to retrieve the
| URI string.  The default setting of "AUTO" works for most servers.
| If your links do not seem to work, try one of the other delicious flavors:
|
| 'AUTO'   Default - auto detects
| 'PATH_INFO'  Uses the PATH_INFO
| 'QUERY_STRING' Uses the QUERY_STRING
| 'REQUEST_URI'  Uses the REQUEST_URI
| 'ORIG_PATH_INFO' Uses the ORIG_PATH_INFO
|
*/
$config['uri_protocol'] = 'AUTO';

/*
|--------------------------------------------------------------------------
| URL suffix
|--------------------------------------------------------------------------
|
| This option allows you to add a suffix to all URLs generated by CodeIgniter.
| For more information please see the user guide:
|
| http://codeigniter.com/user_guide/general/urls.html
*/
$config['url_suffix'] = '';

$config['use_category_name'] = 'y';
$config['use_membership_captcha'] = 'n';
$config['user_session_type'] = 'c';
$config['webmaster_email'] = 'admin@site.com';
$config['webmaster_name'] = '';
$config['word_separator'] = 'dash';
$config['word_wrap'] = 'y';
$config['xml_lang'] = 'en';
$config['xss_clean_uploads'] = 'y';

Last updated September 21, 2012.