settings.ini.cfm Reference - Mura Docs v6

settings.ini.cfm Reference

Settings

mode=production
Description: Sets the mode per the appropriate settings in the section defined as [production], [development], [etc]. A complete set of attributes is required. Duplicate the default production set here and edit as necessary.
Options: production, development, staging, etc.
appname=Mura CMS
Description: Forthcoming
Options: Forthcoming
appReloadKey=appreload
Description: Name of the url variable used to reload Mura. Best practice suggests changing this for security through obscurity.
installed=0
Description: Forthcoming
Options: Forthcoming

Production

title=Mura CMS
Description: This prepends the Site Name in the <title> tag of the Mura Admin.
 
filedir
Description: Optional. This redefines the file system path for storing site assets that are uploaded through the editor, component cacheing, files associated with a specific content node. If this is not set, it will place all assets into the local site ID directory. Defaults to the Mura webroot (not the webrootmap set here)+assetpath-the context.
Example: "c:\inetpub\assets"
 
fileStore
Description: Defines where you store content-node associated files such as a gallery item, or file.
Options: database, fileDir, or s3
 
fileStoreAccessInfo
Description: This is the a caret-delimited string for Amazon S3 file storage service following the convention of "Access Key ID^Secret Access Key^Bucket"
Example: 0EGQ0TXQW1dsfhgsdfR6C602^JtyxuImafdgfdIaV+g7edhNpmcpIQ00eokGaCGpC^files.yourdomain.com
 
assetdir
Description: A custom filepath to where your site assets should be stored
Example: c:\inetpub\site\tasks\sites
 
assetpath
Description: The URL to where assets are stored. Can be a domain or root relative path.
Example: /index.cfm/tasks/sites (no trailing slash), http://assets.domain.com
 
plugindir
Description: A custom filepath to where your plugins will be installed
Example: c:\inetpub\site\plugins
 
usefilemode
Description: Option to specify that Mura set file permissions. (Only useful on Unix based systems.)
Options: true/false
 
mapdir=mura
Description: This is a deprecated setting specific to ColdFusion MX 7 that is not supported. Do not change.
 
webrootmap=murawrm
Description: This is a ColdFusion MX 7 specific setting to tell Mura what your mapping is in the CFMX7 administrator. Do not change.
 
datasource=muradb
Description: This the Data Source Name (DSN) created for Mura. This is usually done in the ColdFusion or Railo administrator, or in the control panel of your host if you are installing Mura in a shared environment. Please note that if you are installing Mura in a shared environment, this will likely need to be changed to something other than "muradb" to make sure it is unique to the server.
 
dbType=mssql
Description: This sets the type of database you are using. Mura currently supports MySQL 4+, MS SQL 2005+ and Oracle 10g(+?).
Options: mssql, mysql, oracle
 
dbUsername
Description: This is the username used to log into your database.
 
dbPassword
Description: This is the password used to log into your database.
 
context
Description: If you are installing Mura into a sub-directory, you will need to set the context to that directory.
Example: /nameofdirectory (no trailing slash)
 
admindomain
Description: Optional. Binds the Mura admin to a specific domain especially for SSL or obscuring access to the Mura admin.
Example: admin.yoursite.com
 
indexfile=index.cfm
Description: Deprecated.
 
adminemail
Description: Secondary email settings for emails that need to be sent that are not associated with a specific site such as the Mura admin.
Example: user@domain.com
 
mailserverip
Description: The server used to send emails from Mura.
Example: mail.domain.com, 267.11.98.23
 
mailserversmtpport
Description: Port of the mail server you'd like Mura to use to send emails such as review notifications, login/password resets, Email Broadcaster email, etc. Defaults to 25.
 
mailserverpopport
Description: Port of the mail server you'd like Mura to check for bounced emails from the Email Broadcaster. Defaults to 110.
 
mailserverusername
Description: This is the username used to log into or send emails from the adminemail account.
 
mailserverpassword
Description: This is the password used to log into the adminemail account.
 
mailservertls
Description: Option to use TLS while connecting to your mailserver.
Options: 1,0
 
mailserverssl
Description: Option to use SSL while connecting to your mailserver.
Options: 1,0
 
usedefaultsmtpserver
Description: Setting this to 1 will allow Mura to use the default SMTP server specified in your application server. Alternatively, you can use a different email server by specifying the mailserverip, mailserverusername and mailserverpassword below.
Options: 1, 0
 
adminssl
Description: If you have an SSL certificate on your domain.
Options: 1, 0
 
logEvents
Description: Creates log files for tracking events in Mura.
Options:1, 0
 
debuggingEnabled=true
Description: Toggles debugging on errors between the default app server debugging output or the error.html file found in /config.
Options: true, false
 
port
Description: This is the default http port for your webserver. If you need to use another such as 8500 (for a local ColdFusion deployment), set it here. Defaults to 80.
 
sessionHistory
Description: This sets the number of days that will be stored for session tracking stats in the Mura Dashboard and associated reports. This has the potential to impact database storage significantly so for sites with more traffic, it should be adjusted as necessary. Defaults to 1 day.
 
dashboard
Description: Toggles the Mura Dashboard on or off. If you'd like to not use the Mura Dashboard and have users directed to the Mura Site Manager instead, set this to false. Defaults to True.
 
locale
Description: Renders Dates and Currency per the servers locale or clients locale. Defaults to server.
Options: server, client
 
ping
Description: This controls the scheduled task Mura creates for publishing scheduled content, sending scheduled emails, etc. If this functionality is important to you, leave it set to 1. Defaults to 0.
Options: 1,0
 
enablemuratag
Description: Toggles rendering of the [mura ] tag. Defaults to true.
Options: true, false
 
proxyuser
Description: Proxy username setting for when Mura must use a proxy server to access the internet.
Options: username.
 
proxypassword
Description: Proxy password setting for when Mura must use a proxy server to access the internet.
Options: password.
 
proxyserver
Description: Proxy server setting for when Mura must use a proxy server to access the internet.
Options: server name.
 
proxyport
Description: Proxy port setting for when Mura must use a proxy server to access the internet. Defaults to 80.
Options: numeric port value.
 
sortpermission
Description: Option to extend 'sorting' permission to built in Mura editing levels.
Options: editor, author.
 
imageinterpolation
This sets the image quality when uploading images as content in Mura. For example, images associated with specific content and image galleries.
This setting does not apply to any images uploaded via the WYSIWYG editor.
Options (defined by ColdFusion, not Mura): highestquality, lanczos, highquality, mitchell, mediumPerformance, quadratic, mediumquality, hamming, hanning, hermite, highPerformance, blackman, bessel, highestPerformance, nearest, bicubic, bilinear.
Note: There is a great blog post by Ray Camden that suggests the time it takes to process an image at each setting.
 
productiondatasource
Description: When mode is set to "staging", this and the following settings define where to deploy content.
 
productionassetpath
Description: Same as AssetPath above but specific to production environment
 
productionWebroot
Description: Same as WebRoot above but specific to production environment
 
productionFiledir
Description: Same as FileDir above but specific to production environment
 
siteidinurls
Description: Toggles the siteID (i.e. default, mynewsite, etc.) in URLS to give you a URL of http://www.yoursite.com/index.cfm/about/ instead of http://www.yoursite.com/default/index.cfm/about/. Important: If siteID's are toggled off, each site MUST have a unique URL assigned to it in "Site Settings". To remove the index.cfm from URLs, you must use URL rewriting on your webserver via ISAPI rewrite (IIS) or mod_rewrite (apache). Defaults to 1.
Options: 1, 0.
indexfileinurls
Description: Toggles the beginning "/index.cfm" from the in URLS to give you a URL of http://www.yoursite.com/about/ instead of http://www.yoursite.com/index.cfm/about/. Important: This must be used in conjunction with setting the above siteidinurls attribute to 0. You must also use URL rewriting on your webserver via ISAPI rewrite (IIS) or mod_rewrite (apache) to write requested URLs back to http://www.yoursite.com/index.cfm/about/.  Defaults to 1.
Options: 1, 0.
 
strictextendeddata
Description: Toggles whether extended data is strictly typed.  Defaults to 0.
Options: 1, 0.
 
loginstrike
Description: Sets the number of attempts that a username can attempt to login before it is blocked for 10 minutes.  Defaults to 4.
 
tempdir
Description: Sets the temp directory that Mura will use for uploading files. Defaults to getTempDir().
 
purgedrafts
Description: Tells Mura whether to purge drafts when a new active version is published. Defaults to true.
Options: True, False
 
confirmsaveasdraft
Description: Tells Mura whether ask users whether to save changes as a draft when leaving the main content edtiing page. Defaults to true.
Options: True, False
 
notifywithversionlink
Description: Tells Mura when notifications for review are sent whether to send return link to the version history page or directly to the version edit form. Defaults to true.
Options: True, False
 
autoresetpasswords
Description: Tells Mura whether to reset a users password or just send an email with a auto login link. Defaults to False.
Options: True, False
 
encryptionkey
Description: The encryption key used for the Mura remember me functionality. Can be used for custom development. 
 
sessiontimeout
Description: Set the amount of time a user can leave an admin screen open before being automatically logged out. If set to 0 then the auto logout functionily will not execute. Defaults to 180.