Config Items
CFConfig supports over 200 individual config items. Here's the list of settings that CFConfig can manage
// One of the strings "never", "once", "always"
name='inspectTemplate' type='string'
// Number of templates to cache
name='templateCacheSize' type='numeric'
// Number of queries to keep in cache
name='queryCacheSize' type='numeric'
// true/false When checked, at server level internal cache is used to store cached queries. By default, cached queries are stored in QUERY region supported by Ehcache.
// Adobe-only
name='QueryInternalCacheEnabled' type='boolean'
// True/false
name='componentCacheEnabled' type='boolean'
// True/false
name='saveClassFiles' type='boolean'
// True/false
name='UDFTypeChecking' type='boolean'
// true/false
name='nullSupport' type='boolean'
// true/false
name='dotNotationUpperCase' type='boolean'
// true/false
name='suppressWhitespaceBeforecfargument' type='string'
// One of the strings "standard", "small", "strict"
name='scopeCascading' type='string'
// True/false
name='searchResultsets' type='boolean'
name='baseComponent' type='string'
// Charts can be cached either in memory or to disk. In memory caching is faster, but more memory intensive. (0 = memory cache, 1 = disk cache)
name='chartCacheType' type='numeric'
// Time-to-Live of each chart in seconds
name='chartCacheTTL' type='numeric'
// Maximum number of cached images
name='chartCacheSize' type='numeric'
// Disk cache location. When caching to disk, specifies the directory in which to store the generated charts.
name='chartCacheDiskLocation' type='string'
// Ex: en_US
name='thisLocale' type='string'
// Ex: America/Chicago
name='thisTimeZone' type='string'
// Ex: pool.ntp.org
name='timeServer' type='string'
// true/false
name='useTimeServer' type='boolean'
// Ex: windows-1252 (Lucee: Default character used to read templates (*.cfm and *.cfc files))
name='templateCharset' type='string'
// Ex: UTF-8 (Lucee: Default character set for output streams, form-, url-, and cgi scope variables and reading/writing the header)
name='webCharset' type='string'
// Ex: windows-1252 (Default character set for reading from/writing to various resources)
name='resourceCharset' type='string'
// One of the strings "cfml", "j2ee"
name='sessionType' type='string'
// True/false
name='mergeURLAndForm' type='boolean'
// True/false
name='applicationManagement' type='boolean'
// True/false
name='sessionManagement' type='boolean'
// True/false
name='clientManagement' type='boolean'
// True/false
name='domainCookies' type='boolean'
// True/false
name='clientCookies' type='boolean'
// Cookie Timeout - Number of seconds
name='sessionCookieTimeout' type='numeric'
// True/false
name='sessionCookieHTTPOnly' type='boolean'
// True/false
name='sessionCookieSecure' type='boolean'
// Disable updating ColdFusion internal cookies using ColdFusion tags/functions - True/false
name='sessionCookieDisableUpdate' type='boolean'
// Cookie Samesite default value - Strict, Lax, None, or empty string
name='sessionCookieSamesite' type='string'
// One of the strings "classic", "modern"
name='localScopeMode' type='string'
// True/false
name='CGIReadOnly' type='string'
// Timespan Ex: 0,5,30,0
name='sessionTimeout' type='string'
// Timespan Ex: 0,5,30,0
name='applicationTimeout' type='string'
// Timespan Ex: 0,5,30,0
name='sessionMaximumTimeout' type='string'
// Timespan Ex: 0,5,30,0
name='applicationMaximumTimeout' type='string'
// One of the strings "none", "mixed", "modern", "classic"
name='applicationListener' type='string'
/* One of the strings
* "curr2root" - Current dir to web root (Lucee and Adobe [option 2])
* "curr" - Current dir only (Lucee only)
* "root" - Only in web root (Lucee only)
* "currorroot" - Current dir or web root (Lucee and Adobe [option 3])
* "curr2driveroot" - Current dir to drive root (Adobe only [option 1])
*/
name='applicationMode' type='string'
// Timespan Ex: 0,5,30,0
name='clientTimeout' type='string'
// One of the strings "memory", "file", "cookie", <cache-name>, <datasource-name>
name='sessionStorage' type='string'
// One of the strings "memory", "file", "cookie", <cache-name>, <datasource-name>, "Registry"
name='clientStorage' type='string'
// Number of minutes between client storage purge. Not to be less tham 30 minutes.
name='clientStoragePurgeInterval' type='numeric'
// A struct of valid client storage locations including registry, cookie, and any configured datasources. Only used by Adobe.
name='clientStorageLocations' type='struct'
// TODO: Add functions/commands to manage this manually.
// One of the strings "memory", "redis". Adobe use only.
name='sessionStorageLocation' type='string'
// Passowrd for session storage. Adobe use only.
name='sessionStoragePassword' type='string'
// Host for session storage. Adobe use only.
name='sessionStorageHost' type='string'
// Timeout in ms for session storage. Adobe use only.
name='sessionStorageTimeout' type='numeric'
// Port for session storage Adobe use only.
name='sessionStoragePort' type='numeric'
// Timespan Ex: 0,5,30,0
name='requestTimeout' type='string'
// True/false
name='requestTimeoutEnabled' type='boolean'
// Blocked file extensions for CFFile uploads
name='blockedExtForFileUpload' type='string'
// "none", "all" or a comma-delimited list with some combination of "cgi", "cookie", "form", "url".
name='scriptProtect' type='string'
// True/false
name='perAppSettingsEnabled' type='boolean'
// True/false
name='useUUIDForCFToken' type='boolean'
// True/false
name='requestTimeoutInURL' type='boolean'
// One of the strings "off", "simple", "smart"
// for Lucee backwards compat, you can use "regular", "white-space", "white-space-pref" which map to the above options in the same order.
// Adobe only has on and off so "simple" and "smart" both just map to the fetaure being on.
name='whitespaceManagement' type='string'
// True/false
name='compression' type='boolean'
// True/false
name='supressContentForCFCRemoting' type='boolean'
// True/false
name='bufferTagBodyOutput' type='boolean'
// Key is datasource name, value is struct of properties
name='datasources' type='struct'
// Preserve single quotes (") in the SQL defined with the tag cfquery (Lucee only)
name='datasourcePreserveSingleQuotes' type='boolean'
// Array of structs of properties. Mail servers are uniquely identified by host
name='mailServers' type='array'
/**
* Custom tags have no unique identifier. In Adobe, there's a made up
* "virtual" key of /WEB-INF/customtags(somenumber), but it's never shown
* topside. In Lucee, you *could* name a path, but you don't have to.
*
* We're going to store in an array, and later if we need to determine
* uniqueness, we'll manufacture a key to do so.
*/
// Array of tag paths ( value struct of properties )
name='customTagPaths' type='array'
// Search for custom tags in subdirectories. (Lucee only)
name='customTagSearchSubdirectories' type='boolean'
// Search in the caller directory for the custom tag. (Lucee only)
name='customTagSearchLocal' type='boolean'
// component path is cached and not resolved again. (Lucee only)
name='customTagCachePaths' type='boolean'
// These are the extensions used for Custom Tags, in the order they are searched.
name='customTagExtensions' type='string'
// Component search paths (Lucee only). Key is the name
name='componentPaths' type='struct'
// Encoding to use for mail. Ex: UTF-8
name='mailDefaultEncoding' type='string'
// True/false enable mail spooling
name='mailSpoolEnable' type='boolean'
// Number of seconds for interval
name='mailSpoolInterval' type='numeric'
// Number of seconds to wait for mail server response
name='mailConnectionTimeout' type='numeric'
// True/false to allow downloading attachments for undelivered emails
name='mailDownloadUndeliveredAttachments' type='boolean'
// Sign messages with cert
name='mailSignMesssage' type='boolean'
// Path to keystore
name='mailSignKeystore' type='string'
// Password to the keystore
name='mailSignKeystorePassword' type='string'
// Alias of the key with which the certificcate and private key is stored in keystore. The supported type is JKS (java key store) and pkcs12.
name='mailSignKeyAlias' type='string'
// Password with which the private key is stored.
name='mailSignKeyPassword' type='string'
// true/false Log all mail messages sent by ColdFusion. Select this check box to save the To, From, and Subject fields of messages to a log file.
name='mailLogEnabled' type='boolean'
// Error Log Severity. Select the type of SMTP-related error messages to log.
// One of the strings "debug", "information", "warning", "error"
name='mailLogSeverity' type='string'
// Number of mail delivery threads
name='mailMaxThreads' type='numeric'
// Key is virtual path, value is struct of properties
name='CFMappings' type='struct'
// Key is log name, value is struct of properties
name='loggers' type='struct'
// Enable HTTP status codes. ColdFusion sets an error status code of 404 if the template is not found and an error status code of 500 for server errors.
name='errorStatusCode' type='boolean'
// True/false
name='disableInternalCFJavaComponents' type='boolean'
// True/false
name='secureJSON' type='boolean'
// A string representing the JSON prefx like "//"
name='secureJSONPrefix' type='string'
// Number of KB for buffer size (1024)
name='maxOutputBufferSize' type='numeric'
// True/false
name='inMemoryFileSystemEnabled' type='boolean'
// Number of MB for in memory file system
name='inMemoryFileSystemLimit' type='numeric'
// Number of MB for in memory application file system
name='inMemoryFileSystemAppLimit' type='numeric'
// True/false
name='watchConfigFilesForChangesEnabled' type='boolean'
// Number of seconds
name='watchConfigFilesForChangesInterval' type='numeric'
// List of file extensions. Ex: "xml,properties"
name='watchConfigFilesForChangesExtensions' type='string'
// True/false
name='allowExtraAttributesInAttrColl' type='boolean'
// True/false
name='disallowUnamedAppScope' type='boolean'
// True/false
name='allowApplicationVarsInServletContext' type='boolean'
// Number of minutes
name='CFaaSGeneratedFilesExpiryTime' type='numeric'
// Absolute path to store index files for ORM search.
name='ORMSearchIndexDirectory' type='string'
// default path (relative to the web root) to the directory containing the cfform.js file.
name='CFFormScriptDirectory' type='string'
// Your Google maps API key
name='googleMapKey' type='string'
// Your Lucee API key (Lucee doesn't use it, but ForgeBox will since it's passed to extension providers)
name='APIKey' type='string'
// True/false
name='serverCFCEenabled' type='boolean'
// Specify the absolute path to a CFC having onServerStart() method, like "c:\server.cfc". Or specify a dot delimited CFC path under webroot, like "a.b.server". By default, ColdFusion will look for server.cfc under webroot.
name='serverCFC' type='string'
// file extensions as a comma separated list which gets compiled when used in the CFInclude tag * for all.
name='compileExtForCFInclude' type='string'
/* Error Templates. One of the strings
* "default" - Standard handling for engine. Blank for Adobe, "error.cfm" for Lucee/Railo. Not secure.
* "secure" - Uses the engine's secure template.
* "neo" - Mirrors appearance of default Adobe handler (Lucee/Railo)
* Alternatively, you can provide the path to a custom template
*/
name='generalErrorTemplate' type='string'
name='missingErrorTemplate' type='string'
// Maximum number of parameters in a POST request sent to the server.
name='postParametersLimit' type='numeric'
// Limits the amount of data in MB that can be posted to the server in a single request.
name='postSizeLimit' type='numeric'
// Requests smaller than the specified limit in MB are not handled by the throttle.
name='throttleThreshold' type='numeric'
// Limits total memory size in MB for the throttle
name='totalThrottleMemory' type='numeric'
// Maximum number of simultaneous Template requests
name='maxTemplateRequests' type='numeric'
// Maximum number of simultaneous Flash Remoting requests
name='maxFlashRemotingRequests' type='numeric'
// Maximum number of simultaneous Web Service requests
name='maxWebServiceRequests' type='numeric'
// Maximum number of simultaneous CFC function requests
name='maxCFCFunctionRequests' type='numeric'
// Maximum number of simultaneous Report threads
name='maxReportRequests' type='numeric'
// Maximum number of threads available for CFTHREAD
name='maxCFThreads' type='numeric'
// Timeout requests waiting in queue after XX seconds
name='requestQueueTimeout' type='numeric'
// Request Queue Timeout Page
name='requestQueueTimeoutPage' type='string'
// Key is cache connection name, value is struct of properties
name='caches' type='struct'
// Array of extension provider URLs (strings)
name='extensionProviders' type='array'
// name of default Object cache connection
name='cacheDefaultObject' type='string'
// name of default function cache connection
name='cacheDefaultFunction' type='string'
// name of default Template cache connection
name='cacheDefaultTemplate' type='string'
// name of default Query cache connection
name='cacheDefaultQuery' type='string'
// name of default Resource cache connection
name='cacheDefaultResource' type='string'
// name of default Include cache connection
name='cacheDefaultInclude' type='string'
// name of default File cache connection
name='cacheDefaultFile' type='string'
// name of default HTTP cache connection
name='cacheDefaultHTTP' type='string'
// name of default WebService cache connection
name='cacheDefaultWebservice' type='string'
// Line Debugger Settings - Allow Line Debugging
name='lineDebuggerEnabled' type='boolean'
// Line Debugger Settings - Debugger Port
name='lineDebuggerPort' type='numeric'
// Line Debugger Settings - Maximum Simultaneous Debugging Sessions:
name='lineDebuggerMaxSessions' type='numeric'
// Enable robust error information (Adobe only)
name='robustExceptionEnabled' type='boolean'
// Enable Ajax debugging window (Adobe only)
name='ajaxDebugWindowEnabled' type='boolean'
// "Enable Request Debugging Output" in Adobe / "Enable debugging" in Lucee
name='debuggingEnabled' type='boolean'
// Remote DOM Inspection Settings
name='weinreRemoteInspectionEnabled' type='boolean'
// Report Execution Times
name='debuggingReportExecutionTimes' type='boolean'
// Database Activity - Select this option to log the database activity for the SQL Query events and Stored Procedure events. - Lucee only
name='debuggingDBEnabled' type='boolean'
// Exceptions - Select this option to log all exceptions raised for the request. - Lucee only
name='debuggingExceptionsEnabled' type='boolean'
// Query Usage - Select this option to log the query usage information. - Lucee only
name='debuggingQueryUsageEnabled' type='boolean'
// Tracing -Select this option to log trace event information. Tracing lets a developer track program flow and efficiency through the use of the CFTRACE tag. - Lucee only
name='debuggingTracingEnabled' type='boolean'
// Dump - Select this option to enable output produced with help of the tag cfdump and send to debugging. - Lucee only
name='debuggingDumpEnabled' type='boolean'
// Timer - Select this option to show timer event information. Timers let a developer track the execution time of the code between the start and end tags of the CFTIMER tag. - Lucee only
name='debuggingTimerEnabled' type='boolean'
// Implicit variable Access - Select this option to log all accesses to scopes, queries and threads that happens implicit (cascaded). - Lucee only
name='debuggingImplicitVariableAccessEnabled' type='boolean'
// Maximum Logged Requests - Lucee only
name='debuggingMaxLoggedRequests' type='numeric'
// Debugging Templates - Lucee only
name='debuggingTemplates' type='struct'
// Debugging Highlight templates taking longer than the following ms
name='debuggingReportExecutionTimesMinimum' type='numeric'
// Debugging Use the following output mode for long template request execution times
name='debuggingReportExecutionTimesTemplate' type='string'
// Debugging Output Format (dockable.cfm, classic.cfm)
name='debuggingTemplate' type='string'
// Debugging show General debug information
name='debuggingShowGeneral' type='boolean'
// Debugging show Database Activity
name='debuggingShowDatabase' type='boolean'
// Debugging show Exception Information
name='debuggingShowException' type='boolean'
// Debugging show Tracing Information
name='debuggingShowTrace' type='boolean'
// Debugging show Timer Information
name='debuggingShowTimer' type='boolean'
// Debugging Flash Form Compile Errors and Messages
name='debuggingShowFlashFormCompileErrors' type='boolean'
// Debugging Variables. Select this option to enable variable reporting.
name='debuggingShowVariables' type='boolean'
// Debugging include application vars
name='debuggingShowVariableApplication' type='boolean'
// Debugging include cgi vars
name='debuggingShowVariableCGI' type='boolean'
// Debugging include client vars
name='debuggingShowVariableClient' type='boolean'
// Debugging include cookie vars
name='debuggingShowVariableCookie' type='boolean'
// Debugging include form vars
name='debuggingShowVariableForm' type='boolean'
// Debugging include request vars
name='debuggingShowVariableRequest' type='boolean'
// Debugging include server vars
name='debuggingShowVariableServer' type='boolean'
// Debugging include session vars
name='debuggingShowVariableSession' type='boolean'
// Debugging include URL vars
name='debuggingShowVariableURL' type='boolean'
// Debugging IP Addresses
name='debuggingIPList' type='string'
// Monitoring Service Port (Only used by Adobe CF)
// The port for the monitoring service to bind to
name='monitoringServicePort' type='numeric'
// The host for the monitoring service to bind to
// See https://tracker.adobe.com/#/view/CF-4202562
name='monitoringServiceHost' type='string'
// .NET Services (Only used by Adobe CF)
// Java port for .NET services
name='dotNetPort' type='numeric'
// .Net port of JNBridge for .NET services
name='dotNetClientPort' type='numeric'
// Install path to the .NET services
name='dotNetInstallDir' type='string'
// Protocol for the .NET services. Possible options: TCP, ??
name='dotNetProtocol' type='string'
// Log directory
name='logDirectory' type='string'
// Maximum file size (In KB)
name='logMaxFileSize' type='numeric'
// Maximum number of archives
name='logMaxArchives' type='numeric'
// Log slow pages taking longer than
name='logSlowRequestsEnabled' type='boolean'
// Number of seconds threshold for logging slow pages
name='logSlowRequestsThreshold' type='numeric'
// Log all CORBA calls
name='logCORBACalls' type='boolean'
// Adobe && UNIX ONLY - Use operating system logging facilities
name='logSysLogEnabled' type='boolean'
// Array of disabled log file names (Adobe CF only)
name='logFilesDisabled' type='array'
// PDF Service Managers (Adobe CF only)
name='PDFServiceManagers' type='struct'
// TODO:
//name='externalizeStrings' type='string'
//name='restMappings' type='array'
//name='componentBase' type='string'
//name='componentAutoImport' type='string'
//name='componentSearchLocal' type='boolean'
//name='componentImplicitNotation' type='boolean'
//name='cfxTags' type='string'
// Enable logging for scheduled tasks
name='schedulerLoggingEnabled' type='boolean'
name='schedulerClusterDatasource' type='string'
name='schedulerLogFileExtensions' type='string'
name='scheduledTasks' type='struct'
// Enable Event Gateway Services
name='eventGatewayEnabled' type='boolean'
// Maximum number of events to queue
name='eventGatewayMaxQueueSize' type='numeric'
// Event Gateway Processing Threads
name='eventGatewayThreadpoolSize' type='numeric'
// Event Gateways > Gateway Instances
name='eventGatewayInstances' type='array'
// Services > Event Gateway - Lucee specific
// Lucee and Adobe event gateways are very different and cannot be transfered between engines. As such, they are stored separately
name='eventGatewaysLucee' type='struct'
// Event Gateways > Gateway Types
name='eventGatewayConfigurations' type='array'
// Enable WebSocket Service
name='websocketEnabled' type='boolean'
// Enable Flash remoting
name='FlashRemotingEnable' type='boolean'
// Enable Remote Adobe LiveCycle Data Management access
name='flexDataServicesEnable' type='boolean'
// Enable RMI over SSL for Data Management
name='RMISSLEnable' type='boolean'
// RMI SSL Keystore
name='RMISSLKeystore' type='string'
// RMI SSL Keystore Password
name='RMISSLKeystorePassword' type='string'
// Plain text admin password
name='adminPassword' type='string'
// Plain text admin RDS password
name='adminRDSPassword' type='string'
// True/false is RDS enabled?
name='adminRDSEnabled' type='boolean'
// Plain text default password for new Lucee web context
name='adminPasswordDefault' type='string'
// hashed salted password for Lucee
name='hspw' type='string'
// hashed password for Lucee/Railo
name='pw' type='string'
// Salt for admin password in Lucee
name='adminSalt' type='string'
// hashed salted default password for new Lucee web context
name='defaultHspw' type='string'
// hashed default password for new Lucee/Railo web context
name='defaultPw' type='string'
// Password required for admin
name='adminLoginRequired' type='boolean'
// Password required for RDS
name='adminRDSLoginRequired' type='boolean'
// user ID required for admin login. False means just a password is required
name='adminUserIDRequired' type='boolean'
// user ID required for RDS login. False means just a password is required
name='adminRDSUserIDRequired' type='boolean'
// Default/root admin user ID
name='adminRootUserID' type='string'
// Allow more than one user to be logged into the same userID at once in the admin
name='adminAllowConcurrentLogin' type='boolean'
// Enable sandbox security
name='sandboxEnabled' type='boolean'
// define the access for reading data from the admin. One of the strings open, closed, or protected
name='adminAccessWrite' type='string'
// define the access for writing data from the admin. One of the strings open, closed, or protected
name='adminAccessRead' type='string'
// List of allowed IPs for exposed services. Formatted like 1.2.3.4,5.6.7.*
name='servicesAllowedIPList' type='string'
// List of allowed IPs for admin access. Formatted like 1.2.3.4,5.6.7.*
name='adminAllowedIPList' type='string'
// Enable secure profile. Note, fipping this flag doesn't actually change any of the security settings. It really just tracks the fact that you've enabled it at some point.
name='secureProfileEnabled' type='boolean'
// System output streams - Lucee only
// values are strings indicating target stream (default,null,class:<class>,file:<file>)
name='systemOut' type='string'
name='systemErr' type='string'
// TODO: adminUsers array (AuthorizedUsers)
// TODO: sandboxes (contexts)
// License key (only used for Adobe)
name='license' type='string'
// Previous license key (required for an upgrade license key)
name='previousLicense' type='string'
// TODO: Figure out what hashing algorithms each version of ACF use, and share the
// same setting so the hashes passwords are as portable as possible
// hashed admin password for Adobe CF11
// TODO: Need to get 10, 11, 2016, and 2018 ironed out here.
name='ACF11Password' type='string'
// hashed RDS password for Adobe CF11
name='ACF11RDSPassword' type='string'
// Automatically Check for Updates. Select to automatically check for updates at every login.
name='updateCheckOnLoginEnable' type='boolean'
// Check for updates every X days Enable
name='updateCheckOnScheduleEnable' type='boolean'
// Number of days between updates
name='updateCheckOnScheduleDays' type='numeric'
// If updates are available, send email notification to (comma-delimited list)
name='updateCheckOnScheduleToAddress' type='string'
// If updates are available, send email notification from
name='updateCheckOnScheduleFromAddress' type='string'
// Update site URL
name='updateSiteURL' type='string'
// Update check proxy host
name='updateProxyHost' type='string'
// Update check proxy port
name='updateProxyPort' type='numeric'
// Update check proxy username
name='updateProxyUsername' type='string'
// Update check proxy password
name='updateProxyPassword' type='string'
Last modified 1yr ago