This page last changed on Nov 05, 2009 by don.willis@atlassian.com.

Confluence has a small number of obscure configuration and debugging settings that can be enabled through Java system properties. System properties are usually set by passing the -D flag to the Java virtual machine in which Confluence is running. (Refer to the full instructions.)

Property Since Default Value Module... Effect
atlassian.forceSchemaUpdate 1.0 true atlassian-config By default, Confluence will only run its database schema update when it detects that it has been upgraded. This flag will force Confluence to perform the schema update on system startup.
confluence.home 1.0 Any filesystem path Confluence and atlassian-config If this system property is set, Confluence will ignore the contents of the confluence-init.properties file, and use this property as the setting for the Confluence Home directory.
confluence.devmode 1.0 true Confluence Enables additional debugging options that may be of use to Confluence developers. Do not enable this flag on a production system.
confluence.disable.mailpolling 2.4 false Confluence If set to "true", will prevent Confluence from retrieving mail for archiving within spaces. Manually triggering "check for new mail" via the web UI will still work. This property has no effect on outgoing mail
confluence.i18n.reloadbundles 1.0 true Confluence Setting this property will cause Confluence to reload its i18n resource bundles every time an internationalised string is looked up. This can be useful when testing translations, but will make Confluence run insanely slowly.
confluence.ignore.debug.logging 1.0 true Confluence Confluence will normally log a severe error message if it detects that DEBUG level logging is enabled (as DEBUG logging generally causes a significant degradation in system performance). Setting this property will suppress the error message.
confluence.jmx.disabled 3.0 false Confluence If set to "true", will disable Confluence's JMX monitoring. This has the same effect as setting the "enabled" property to false in WEB-INF/classes/jmxContext.xml
confluence.optimize.index.modulo 2.2 20 Confluence Number of index queue flushes before the index is optimised.
confluence.plugins.bundled.disable 2.9 false Confluence Starts confluence without bundled plugins. May be useful in a development environment to make Confluence start quicker, but since bundled plugins are necessary for some of Confluence's core functionality, this property should not be set on a production system.
atlassian.mail.fetchdisabled 1.0 false atlassian-mail Disables mail fetching services for IMAP and POP
atlassian.mail.senddisabled 1.0 false atlassian-mail Disables sending of mail
atlassian.disable.caches 2.4 true atlassian-plugins, atlassian-cache-servlet Setting this property will disable conditional get and expires: headers on some web resources. This will significantly slow down the user experience, but is useful in devlopment if you are frequently changing static resources and don't want to continually flush your browser cache.
org.osgi.framework.bootdelegation 2.10 empty atlassian-plugins Comma-separated list of package names to provide from application for OSGi plugins. Typically required when profiling Confluence. For example: "com.jprofiler.,com.yourkit.".
confluence.diff.timeout 3.1 1000 Confluence Number of milliseconds to wait for a diff operation (comparing two page versions) to complete before aborting with an error message.
RELATED TOPICS

Configuring System Properties

Document generated by Confluence on Nov 05, 2009 23:26