atlassian.forceSchemaUpdate

1.0

false

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

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.dev.mode

1.0

false

Enables additional debugging options that may be of use to Confluence developers (additionally it changes spring bean creation to use lazy initialization by default to decrease startup time). Do not enable this flag on a production system.

confluence.disable.mailpolling

2.4

false

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

Setting this property will cause Confluence to reload its i18n resource bundles every time an internationalized 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 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

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

Number of index queue flushes before the index is optimized.

confluence.plugins.bundled.disable

2.9

false

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.indexing.contentbody.maxsize

When a file is uploaded, its text is extracted and indexed. This allows people to search for the content of a file, not just the filename.

If the amount of content extracted from the file exceeds the limit set by this property (default is 1MB, in bytes), the file's contents will still be indexed and searchable, but will not appear when the file is returned in search results. Increasing this limit may make displaying search results slower. See Configuring Attachment Size for more info.

atlassian.mail.fetchdisabled

3.5

false

Disables mail fetching services for IMAP and POP

atlassian.mail.senddisabled

3.5

false

Disables sending of mail

atlassian.disable.caches

2.4

true

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.

confluence.html.encode.automatic

2.9

Setting this property forces the antixss encoding on or off, overriding the behavior dictated by settings. The default behavior differs between Confluence versions.

org.osgi.framework.bootdelegation

2.10

empty

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.pool.size

3.1

20

Maximum number of concurrent diffs. When that number is exceeded, additional attempts by RSS feeds to create diffs are ignored and logged. (The RSS requests succeed, they are just missing diffs).

confluence.diff.timeout

3.1

1000

Number of milliseconds to wait for a diff operation (comparing two page versions) to complete before aborting with an error message.

confluence.html.diff.timeout

10000

atlassian.user.experimentalMapping

2.10

false

Setting this property changes the relationship between local users and local groups to reduce performance degradation when adding a local user to a local group with a large number of users. Please note, setting this property can slow down other user management functions. We recommend that you set it only if you are experiencing performance problems when adding local users to large local groups. Please refer to CONF-12319, fixed in Confluence 3.1.1.

confluence.import.use-experimental-importer

3.2

false

Setting this property changes Confluence to use the Experimental XML Importer. It is designed to be a more stable implementation but, at the time of the release of 3.2, the importer is largely untested and thus not supported.

atlassian.webresource.disable.minification

3.3

false

Disables automatic minification of JavaScript and CSS resources served by Confluence.

index.queue.thread.count

3.3

See "Effect"

Sets the number of threads to be used for the reindex job. The value has to be in the range of 1 to 50 (inclusive), i.e. at least one thread but no more than 50 threads will be used. There is no default value, i.e.

• If you don't set index.queue.thread.count, the number of threads to be used are calculated based on the number of objects that need to be reindexed and the number of processors available (a maximum of 50 threads will be used).
• If you set index.queue.thread.count=2, then two threads will be used to reindex the content (regardless of the number of objects to be reindexed or the number of processors available)
• If you set index.queue.thread.count=200, then ten threads (the maximum allowed) will be used to reindex the content.

Note: For Confluence versions from 3.3 to 5.6 the maximum threads is 10.

index.queue.batch.size

3.3

1500

Size of batches used by the indexer. Reducing this value will reduce the load that the indexer puts on the system, but indexing takes longer. Increasing this value will cause indexing to be completed faster, but puts a higher load on the system. Normally this setting does not need tuning.

password.confirmation.disabled

3.4

false

This property disables the password confirmation functionality that Confluence uses as an additional security measure. With this property set, Confluence will not require password confirmation for the following actions: administrative actions, change of email address and Captcha for failed logins. Disabling password confirmations is useful if you are using a custom authenticator.

confluence.browser.language.enabled

3.5

true

Setting this property to "false" disables the detection of browser language headers, effectively restoring Confluence behavior to that of earlier releases. Setting this property to "true" enables the detection of the language headers sent by the browser. Confluence will change the UI language based on the browser headers. See documentation on how users can choose a language preference.

upm.pac.disable

Universal Plugin Manager 1.5

false

When this property is set to true, then UPM will not try to access the The Atlassian Marketplace. This is useful for application servers that do not have access to the Internet. See the UPM documentation.

confluence.reindex.documents.to.pop

3.5.9

20

Indicates how many objects each indexing thread should process at a time during a full re-index. Please note that this number does not include attachments.

confluence.reindex.attachments.to .pop

3.5.9

10

Indicates how many attachments each indexing thread should process at a time during a full re-index.

confluence.upgrade.active.directory

3.5.11

false

Forces Confluence to treat any LDAP directories it migrates as Active Directory, rather than relying on looking for sAMAccountName in the username attribute. This is necessary if you are upgrading from before Confluence 3.5, and need to use an attribute other than sAMAccountName to identify your users and are seeing LDAP: error code 4 - Sizelimit Exceeded exceptions in your logs. For more details, see Unable to Log In with Confluence 3.5 or Later Due to 'LDAP error code 4 - Sizelimit Exceeded'

confluence.context.batching.disable

false

com.atlassian.logout.disable.session.invalidation

4.0

false

Disables the session invalidation on log out. As of 4.0 the default behavior is to invalidate the JSession assigned to a client when they log out. If this is set to true the session is kept active (but the user logged out). This may be valuable when using external authentication systems, but should generally not be needed.

officeconnector.spreadsheet.xlsxmaxsize

com.atlassian.confluence.extra.calendar3.display.events.calendar.maxpercalendar

com.atlassian.confluence.allow.downgrade

confluence.skip.reindex

Generally a full reindex is not required when upgrading Confluence, but there may be some occasions where an upgrade task will kick-off the reindex process.

Set this property to true, to skip rebuilding the search index when Confluence is upgraded. This can be useful if you have a very large site and wish to delay rebuilding the index until a time after the upgrade is complete.

reindex.thread.count

reindex.attachments.thread.count

Sets the number of concurrent threads to be used for reindexing attachments specifically, and allows you to reduce the concurrency for these more memory intensive index items.

atlassian.confluence.export.word.max.embedded.images

confluence.mbox.directory

confluence.search.max.results

confluence.upgrade.recovery.file.enabled

confluence.junit.report.directory

officeconnector.textextract.word.docxmaxsize

When a file is uploaded, its text is extracted and indexed. This allows people to search for the content of a file, not just the filename.

Confluence will only extract content from a Word document up to the limit set by this property (defaults to 16MB, in bytes), before proceeding to index it. This will mean that only part of file's contents are searchable. The check uses the uncompressed file size, not the compressed size on disk in the case of .docx files.

See Configuring Attachment Size for more info.

cluster.login.rememberme.enabled

False

In a cluster, setting this property to True will enable the 'Remember Me' checkbox on the login page. This is not recommended in a cluster, and is disabled by default (i.e. 'Remember me' is always on and users can move seamlessly between nodes).

This system property has no effect in standalone Confluence.

confluence.cluster.hazelcast.listenPort

In a cluster, this property can be used to override the default port that Hazelcast will bind to, for example, if the port is unavailable, or you need to run more than one node on the same host (not recommended). It defaults to 5801.

confluence.document.conversion.threads

confluence.document.conversion.threads.wait

confluence.cluster.node.name

confluence.document.conversion.fontpath

Set this property to define a directory where you can add additional fonts to be used when rendering files (in previews and thumbnails).

This is useful if you need to support previewing files with specific fonts, or fonts with multibtye characters (such as Japanese).

confluence.document.conversion.words.defaultfontname

Set this property to change the default font for rendering Word ( .doc and .docx ) files in Confluence.

Specify just the name of the font  (not the path) .

confluence.document.conversion.slides.defaultfontname.regular

Set this property to change the default font for rendering regular fonts in Powerpoint ( .ppt and .pptx ) files in Confluence.

Specify just the name of the font (not the path) .

confluence.document.conversion.slides.defaultfontname.asian

Set this property to change the default font for rendering asian fonts in Powerpoint ( .ppt and .pptx ) files in Confluence.

Specify just the name of the font  (not the path) .

confluence.document.conversion.slides.defaultfontname.symbol

Set this property to change the default font for rendering symbols in Powerpoint ( .ppt and .pptx ) files in Confluence.

This is the font that will be used for bullets and other symbols when the font Symbol is not found.

Specify just the name of the font  (not the path) .

confluence.clickjacking.protection.disable

confluence.cluster.index.recovery.query.timeout

confluence.cluster.index.recovery.generation.timeout

confluence.cluster.index.recovery.num.attempts

com.atlassian.confluence.officeconnector.canary.memory_value

com.atlassian.confluence.officeconnector.canary.timeout

atlassian.plugins.enable.wait

confluence.cluster.hazelcast.max.no.heartbeat.seconds

confluence.startup.remigration.disable

cluster.safety.time.to.live.split.ms

In Confluence Data Center, this is the amount of time (in milliseconds) that the cluster safety job will wait to allow the nodes to rejoin after a split brain is detected. If the node still can't find the cluster safety number in the cache after this time, the node will panic.

confluence.cph.max.entries

confluence.cph.batch.size

synchrony.port (formerly known as reza.port)

This is the port that Synchrony, the service that powers collaborative editing, runs on. You should only need to change this if port 8091 is not available. From 6.0.4, Confluence Server will accept either reza.port or synchrony.port.

synchrony.memory.max (formerly reza.memory.max)

This is the maximum heap size (Xmx) allocated to Synchrony, the service that powers collaborative editing. Change this value if you need to increase or decrease the heap size. From 6.0.4, Confluence Server will accept either reza.memory.max or synchrony.memory.max.  

The default value of this property was increased to 2 gigabytes in 7.10.0.

synchrony.stack.space

This sets the stack size (Xss) of the Synchrony JVM. Increase if you experience stack overflow errors, or decrease if you experience out of memory errors from Synchrony.

This property only applies when Synchrony is managed by Confluence.

synchrony.enable.xhr.fallback

synchrony.database.test.connection.on.checkin

synchrony.proxy.enabled

By default, Confluence uses an internal proxy to communicate between the Confluence JVM and Synchrony JVM. See Administering Collaborative Editing for more information.

In Confluence 6.0, set this property to true to manually enable the internal proxy (useful if you have configured a reverse proxy and want to also use the internal Synchrony proxy).

In Confluence 6.1 or later it should not be necessary to use this system property, as Confluence intelligently determines when to use the proxy.

This property only applies when Synchrony is managed by Confluence. It has no effect on a Synchrony standalone cluster.

synchrony.bind (formerly known as reza.bind)

synchrony.context.path

confluence.pdfexport.permits.size

confluence.pdfexport.timeout.seconds

confluence.flyingpdf.default.characters.per.line

synchrony.host

This is the IP that Confluence uses to connect to Synchrony. It defaults to localhost. Change this if you need to allow Confluence to contact Synchrony via a custom hostname or IP address.

This property only applies when Synchrony is managed by Confluence. It has no effect on a Synchrony standalone cluster.

synchrony.proxy.healthcheck.disabled

page.index.macro.max.pages

atlassian.indexing.attachment.maxsize 

When a file is uploaded, its text is extracted and indexed. This allows people to search for the content of a file, not just the filename.

If the uploaded file is larger than the limit set by this property (default is 100MB, in bytes), text extraction and indexing will be skipped. See Configuring Attachment Size for more info.

officeconnector.excel.extractor.maxlength

When a file is uploaded, its text is extracted and indexed. This allows people to search for the content of a file, not just the filename.

Confluence will only extract content from an Excel spreadsheet up to the limit set by this property (default is 1MB, in bytes), before proceeding to index it. This will mean that only part of file's contents are searchable. See Configuring Attachment Size for more info.

atlassian.image_filter.transform.max_data_size

Applying image effects to large images can cause out of memory errors. We prevent users from applying image effects to images with a data size greater than 16MB.

Set this property, in bytes, to reduce the maximum data size. Note: this is the data size, not the size of the file on disk. 

atlassian.image_filter.transform.max.pixel

Applying image effects to large images can cause out of memory errors. We prevent users from applying image effects to images larger than 4000x4000 pixels.

Set this property, in pixels, to change the maximum image dimensions. 

confluence.collab.edit.user.limit

jobs.limit.per.purge

The Purge Old Job Run Details scheduled job deletes details of old scheduled jobs from the database in batches.

Set this property to change the number of records to remove in each batch.

all.jobs.ttl.hours

By default, the Purge Old Job Run Details scheduled job deletes details of successful scheduled jobs older than 90 days (or 2160 hours).

Set this property, to change number of hours to keep details of successful jobs in the database.

unsuccessful.jobs.ttl.hours

By default, the Purge Old Job Run Details scheduled job deletes details of unsuccessful (failed or aborted) scheduled jobs older than 7 days (or 168 hours).

Set this property, to change number of hours to keep details of unsuccessful jobs in the database.

hide.system.error.details

atlassian.recovery.password

Allows an administrator to start Confluence in recovery mode and specify a temporary administrator password. This is useful if the administrator is locked out of the instance after a site import, or cannot reset their password by other methods. See Restore Passwords To Recover Admin User Rights for more information.

This system property must be removed immediatley after the admin account has been recovered or a new admin account created.

confluence.extra.userlister.limit

conversion.sandbox.pool.size
(formerly document.conversion.sandbox.pool.size)

Use this property to increase the number of processes (sandboxes) in the external process pool. More processes means more tasks can be executed in parallel, but will consume more memory and CPU resources on each node. 

This property only applies to Data Center. This property was renamed in Confluence 6.12.

conversion.sandbox.startup.time.limit.secs
(formerly document.conversion.sandbox.startup.time.limit.secs)

When a document file is inserted into a page, thumbnails are generated of its contents, so it can be viewed inline and previewed. In Confluence Data Center this is handled by the external process pool . 

This property sets the amount of time (in seconds) that a process will wait for document conversion to start, before terminating the process.

This property only applies to Data Center. This property was renamed in Confluence 6.12.

document.conversion.sandbox.request.time.limit.secs

When a document file is inserted into a page, thumbnails are generated of its contents, so it can be viewed inline and previewed. In Confluence Data Center this is handled by the external process pool . 

This property sets the amount of time (in seconds) that a process will wait for document conversion to complete, before terminating the process, and marking thumbnail generation for that file as failed. 

This property only applies to Data Center.

From Confluence 7.8.0 this property also applies to the HTML conversion that occurs when you insert a file using the Office Word or Office Excel macro. 

sandbox.termination.tolerance

This property specifies how often a process in the external process pool will check if the request time limit (set in the request.time.limit.secs property above) has been exceeded. It's calculated by dividing the request time limit by the value of this property. For example, if the request time limit is 30 seconds, and the tolerance set in this property is 5, the process will check if the request time limit has been exceeded every 6 seconds. 

This property only applies to Data Center.

conversion.sandbox.memory.limit.megabytes
(formerly document.conversion.sandbox.memory.limit.megabytes)

When a document file is inserted into a page, thumbnails are generated of its contents, so it can be viewed inline and previewed. In Confluence Data Center this is handled by the external process pool .   

This property limits the amount of heap memory each process in the external process pool can consume. 

This property only applies to Data Center. This property was renamed in Confluence 6.12.

document.conversion.sandbox.log.level

Use this property to change the logging level of document conversion in the external process pool to WARNING, INFO, or FINE. This is useful if you need to troubleshoot a problem with the sandbox.

This property only applies to Data Center.

sandbox.error.delay.millis

This property sets how often (in milliseconds) document conversion errors are captured for diagnostic purposes. 

This property only applies to Data Center.

document.conversion.sandbox.disable

Set this property to true if you don't want to handle document conversion (thumbnail generation) in the external process pool .

When disabled, document conversion will be handled in the Confluence JVM, as is the case in Confluence Server.

This property only applies to Data Center.

conversion.sandbox.java.options

When a document or image file is inserted into a page, thumbnails are generated of its contents, so it can be viewed inline and previewed. In Confluence Data Center this is handled by the external process pool. 

Use this property to override the default value of any of the following Confluence Server system properties (introduced in 7.0.1), and pass new values directly to the JVMs in the external process pool:

• confluence.document.conversion.imaging.convert.timeout
• confluence.document.conversion.imaging.convert.timeout
• confluence.document.conversion.imaging.enabled.tif
• confluence.document.conversion.imaging.enabled.psd

diagnostics.os.check.period.secs

Set this property to change how often operating system diagnostics checks should be performed (in seconds).

This property only applies to the Low free memory (OS-1001) and Low free disk space (OS-1002) alerts.

diagnostics.os.min.free.memory.megabytes

This property applies to the free memory diagnostic alert (OS-1001).

Set this property to change the threshold at which the amount of free memory (in megabytes) should trigger this alert.

diagnostics.os.min.free.disk.space.megabytes

This property applies to the free disk space diagnostic alert (OS-1002).

Set this property to change the threshold at which the amount of free disk space (in megabytes) in the local or shared home directory should trigger this alert.

diagnostics.slow.http.request.secs

This property applies to the HTTP request diagnostic alert (HTTP-1001). This alert is disabled by default.

Set this property to change the threshold (in seconds) at which a slow HTTP request should trigger this alert.

diagnostics.slow.long.running.task.secs

This property applies to the long running task diagnostic alert (JOB-1001).

Set this property to change the threshold (in seconds) at which a long running task should trigger this alert.

diagnostics.slow.macro.rendering.secs

This property applies to the macro rendering diagnostic alert (MACRO-1001). This alert is disabled by default.

Set this property to change the threshold (in seconds) at which rendering a macro on a page should trigger this alert.

diagnostics.jvm.memory.check.period.secs

Set this property to change how often JVM diagnostics checks should be performed (in seconds).

This property only applies to the Thread memory allocation rate (JVM-1001) and Garbage collection ( JVM-1002)alerts.

diagnostics.jvm.memory.allocation.rate.percent

This property applies to the thread memory allocation rate diagnostic alert (JVM-1001). This alert is disabled by default.

Set this property to change the threshold (as a percentage) at which the memory allocation to a particular thread, during the monitoring period (set in diagnostics.jvm.memory.allocation.monitoring.period.secs), should trigger this alert.

diagnostics.jvm.memory.allocation.monitoring.period.secs

This property applies to the thread memory allocation rate diagnostic alert (JVM-1001). This alert is disabled by default.

Set this property to change the monitoring period (in seconds) for this alert.

diagnostics.jvm.garbage.collector.percent

This property applies to the garbage collection diagnostic alert (JVM-1002). This alert checks how much memory has been allocated to garbage collection during the monitoring period (set in diagnostics.jvm.garbage.collector.monitoring.period.secs).

Set this property to change the threshold (as a percentage ) at which the memory allocated to garbage collection should trigger this alert.

diagnostics.jvm.garbage.collector.monitoring.period.secs

This property applies to the garbage collection diagnostic alert (JVM-1002).

Set this property to change the monitoring period (in seconds) for this alert.

diagnostics.alert.retention.period.days

diagnostics.alert.truncation.interval.minutes

pdf.export.sandbox.disable

Set this property to true if you don't want to handle PDF exports in the external process pool.

When disabled, PDF exports will be handled in the Confluence JVM, as is the case in Confluence Server.

This property only applies to Data Center.

pdf.export.sandbox.request.time.limit.secs

When you export a space to PDF, Confluence exports the content of each page to HTML, converts that HTML to PDF, and then finally merges all the pages together into a single PDF file. In Confluence Data Center this is handled by the  external process pool .

This property sets the amount of time (in seconds) that a process should wait to complete, before being terminated. This time limit applies both to the time to convert the content from HTML to PDF, and the time to merge the final PDF file.  

This property only applies to Data Center.

pdf.export.sandbox.memory.requirement.megabytes

In Confluence Data Center PDF exports are handled by the  external process pool . 

This property sets the minimum memory (in megabytes) that a sandbox process must have available to start a PDF export. If conversion.sandbox.memory.limit.megabytes is set to less than the value of this property, PDF export will not start. We don't recommend setting this property to less than 64MB. 

This property only applies to Data Center.

synchrony.eviction.soft.job.threshold.hours

This property changes the behaviour of the Synchrony soft eviction scheduled job. 

It sets the minimum time, in hours, since a Synchrony change log was last modified, to make it eligible to be cleaned up.  By default, only Synchrony change logs last modified more than 3 days ago, for pages/blogs that do not have an active editing session, will be evicted. 

synchrony.eviction.hard.job.threshold.hours

This property changes the behaviour of the Synchrony hard eviction scheduled job

It sets the minimum age, in hours, of content eligible to be evicted by the hard eviction scheduled job. By default, all Synchrony data for any content that is 15 days or older will be evicted by this job, regardless of whether it has been modified more recently. 

confluence.document.conversion.imaging.convert.timeout

When a complex image file (such as ICO, EMF, WMF, plus TIF and PSD if enabled)  is inserted into a page, thumbnails are generated of its contents, so it can be viewed inline and previewed. This process is known to cause out of memory errors for large or complex files.

This property sets the amount of time (in seconds) that Confluence will wait for conversion to complete for an image file, before terminating the process. 

This property applies to Confluence Server and Data Center. For Data Center also see Document conversion for Confluence Data Center

confluence.document.conversion.slides.convert.timeout

When a presentation file (such as PPT, PPTX, POT) is inserted into a page, thumbnails are generated of its contents, so it can be viewed inline and previewed. This process is known to cause out of memory errors for large or complex files.

This property sets the amount of time (in seconds) that Confluence will wait for conversion to complete for a presentation file, before terminating the process. 

This property applies to Confluence Serve and Data Center. For Data Center see Document conversion for Confluence Data Center.

confluence.document.conversion.imaging.enabled.tif

When a file is inserted into a page, thumbnails are generated of its contents, so it can be viewed inline and previewed. By default thumbnails are not generated for TIFF / TIF as they're known to cause out of memory errors.

Set this property to 'true' to turn on thumbnail generation for TIFF files.

If enabled, a timeout will apply to this type of file. This is set by the confluence.document.conversion.imaging.convert.timeout system property. 

This property applies to Confluence Server and Data Center. For Data Center see Document conversion for Confluence Data Center

confluence.document.conversion.imaging.enabled.psd

When a file is inserted into a page, thumbnails are generated of its contents, so it can be viewed inline and previewed. By default thumbnails are not generated for Photoshop PSD files as they're known to cause out of memory errors.

Set this property to 'true' to turn on thumbnail generation for PSD files. 

If enabled, a timeout will apply to this type of file. This is set by the confluence.document.conversion.imaging.convert.timeout system property. 

This property applies to Confluence Server and Data Center. For Data Center see Document conversion for Confluence Data Center.

officeconnector.powerpoint.extractor.maxlength

When a file is uploaded, its text is extracted and indexed. This allows people to search for the content of a file, not just the filename.

Confluence will only extract content from a PowerPoint presentation up to the limit set by this property (default is 1MB, in bytes), before proceeding to index it. This will mean that only part of file's contents are searchable. See Configuring Attachment Size for more info.

confluence.chart.macro.width.max

Maximum width, in pixels, that a chart macro can be set to display on a page. If a higher value is entered, the chart will automatically be reduced to this default. 

confluence.chart.macro.height.max

confluence.search.lucene.termFilterBitSetThreshold

Set this property to change the behaviour of the term filter in Confluence's Lucene based implementation of search. A bitset is only created when the number of matched documents times the threshold set in this property exceeds total number of documents. This will reduce memory usage and improve Confluence performance. You shouldn't need to change this threshold.

page-tree.partial-loading-batch-size

page-tree.partial-loading.disable

confluence.word.import.maxsize

gatekeeper.request-timeout.seconds

Some open-ended queries can take a long time to display when you Inspect Permissions in a Confluence Data Center site with a lot of spaces and users. To avoid this having an impact on your site, we have a timeout.

Set this property to change the length of the timeout, in seconds. You can't set this lower than 30 seconds, or higher than 900 seconds (15 minutes).

plugin.audit.log.view.sysadmin.only
(formerly audit.log.view.sysadmin.only)

Set this property to true to restrict the Audit Log page in Confluence Administration to people with System Administrator global permissions. By default people with System Administrator or Confluence Administrator global permission can access this feature. This property applies to Confluence Server and Data Center.

This property was renamed in 7.7.0.

plugin.audit.file.max.file.count

In Confluence Data Center, audit events are written to an audit log file in the local home directory. These log files are rotated once they reach the file size set by plugin.audit.file.max.file.size. 

Set this property to change the total number of audit log files to keep in the file system. 

plugin.audit.file.max.file.size

In Confluence Data Center, audit events are written to an audit log file in the local home directory.

Set this property to change the maximum file size, in megabytes, that a log file can reach before the log is rotated.

legacy.audit.migrator.num.threads

Sets the number of threads to be used for migrating existing audit log events to the new audit log format when upgrading to Confluence 7.5 or later. 

There is no default value. When not set, Confluence will use 2 times the number of processors available. 

To increase throughput, you can set this property to use a specific number of threads. For example, if you set this property to 16, then 16 threads will be used to migrate the audit log events, regardless of the number of processors available. Note that more threads will result in higher database utilisation.

legacy.audit.migrator.batch.size

Sets the number of audit log events to migrate to the new audit log format, when upgrading to Confluence 7.5 or later. This migration can take a long time in large sites.

When testing your upgrade, if you find the migration is causing performance issue on your Confluence and/or database server, you can set this property to decrease the number of records processed in each batch.

NumberItemPerPageOfPaginatedListAction

Sets the number of items to be listed on the Undefined Pages and Restricted Pages tabs in Space Tools before Confluence paginates the results. 

Set this property to change the number of items to display per page. 

CachingEnablingItemNumber

The Undefined Pages tab in Space Tools provides a list undefined links to pages that do not yet exist.  As this list can be quite memory intensive to generate, the results are cached. 

Set this property to change the maximum number of undefined link references to cache. 

CachingEnablingItemTimeout

The Undefined Pages tab in Space Tools provides a list undefined links to pages that do not yet exist. As this list can be quite memory intensive to generate, the results are cached. 

Set this property to change the amount of time, in minutes, the results should be cached (time to live). 

confluence.child-macro.page-limit

The Children Display macro may load slowly in spaces with a large number of pages, or complex permissions. 

Set this property to specify the maximum number of top-level child pages that can be displayed by the macro. Users can still configure the macro to set a lower value for the Number of Children parameter. 

confluence.child-macro.max-depth

The Children Display macro may load slowly in spaces with a large number of pages, or complex permissions. 

Set this property to specify the maximum depth of descendants that can be displayed by the macro. Users can still configure the macro to set a lower value for the Depth of Descendants parameter. 

confluence.child-macro.disable-excerpt

The Children Display macro may load slowly in spaces with a large number of pages, or complex permissions. 

Set this property to true to never include excerpts. Users can still select a value for the Excerpt Display parameter, but excerpts will not be displayed. 

confluence.event.duration_checker.threshold_in_seconds

When asynchronous events are generated faster than Confluence can process them, we write a message to the application log to advise that we'll process each task synchronously until the queue is cleared.

Set this property to change how often this message appears, in seconds.

This property is also available in the 7.4 Long Term Support release from 7.4.4.

confluence.mailserver.tls.hostname.verification.disabled

Set this property to true if you need to disable TLS hostname verification for any SMTP mail servers you've configured in Confluence. This is not recommended as it can increase the risk of a Man In The Middle attack.

This property is also available in Long Term Support releases from 6.13.17 and 7.4.5.

atlassian.image_filter.transform.max.pixel.drop_shadow

Applying a drop shadow image effect to large images can cause out of memory errors. We prevent users from applying a drop shadow to images larger than 2000x2000 pixels, or the value set by atlassian.image_filter.transform.max.pixel (whichever is smallest).

Set this property, in pixels, to change the maximum image dimensions for drop shadow. 

This property is also available in the 7.4 Long Term Support release from 7.4.4.

pagePropertiesReportContentRetrieverMaxResult

The Page Properties Report macro displays a maximum of 3000 pages. Set this property to decrease the maximum number of pages the macro can display. We don’t recommend you increase this limit, as it can have a performance impact on your site.

This property is also available in the 7.4 Long Term Support release from 7.4.6.

confluence.webhooks.allow.all.hosts

Set this property to true allow administrators to configure localhost URLs as a webhook endpoint. This is disabled by default for security reasons because all ports on the same network can be pinged by the UI.

audit.log.search.disabled

Set this property to true if you do not want to log the Search performed event in the audit log. This event is included by default when the End User Activity coverage area is set to Full, and records the search terms entered in search, advanced search, and in search macros (such as Livesearch and Page Tree Search). 

This property only applies to Data Center.

document.conversion.sandbox.memory.requirement.megabytes

When a Word or Excel document file is inserted into a page using the Office Word or Office Excel macro, its contents are converted to a format that can be viewed inline and previewed.  In Confluence Data Center this is handled by the external process pool. 

This property limits the amount of heap memory, in megabytes, this process in the external process pool can consume. 

This property only applies to Data Center.

atlassian.pats.enabled

Personal access tokens are used to authenticate REST API requests. By default, any user can create a personal access token. 

Set this property to false to prevent users from creating tokens.  Any existing tokens can't be used to authenticate while this property is set to false. 

atlassian.pats.eternal.tokens.enabled

atlassian.pats.max.tokens.expiry.days

atlassian.pats.max.tokens.per.user

atlassian.allow.insecure.url.parameter.login

Set this property to true to use the os_username+os_password query parameter to log in to Confluence.

This login method is blocked by default, and we strongly recommend you use a more secure method, such as personal access tokens.