3.7. Dynamic settings

This section describes how to change your Neo4j configuration while Neo4j is running, and which settings can be changed.

Neo4j Enterprise Edition supports changing some configuration settings at runtime, without restarting the service. The settings are changed using a procedure: dbms.setConfigValue(). Running the dbms.setConfigValue() procedure requires administrator privileges.

Changes to the configuration at runtime are not persisted. To avoid losing changes when restarting Neo4j make sure to update the Neo4j configuration file as well.

3.7.1. Dynamic settings procedure


CALL dbms.setConfigValue(setting, value)


Nothing on success.


Unknown or invalid setting name.

The setting is not dynamic and can not be changed at runtime.

Invalid setting value.

The following example shows how to dynamically enable query logging.

Example 3.5. Set a config value
CALL dbms.setConfigValue('dbms.logs.query.enabled', 'true')

If an invalid value is passed, the procedure will show a message to that effect.

Example 3.6. Try to set invalid config value
CALL dbms.setConfigValue('dbms.logs.query.enabled', 'yes')
Failed to invoke procedure `dbms.setConfigValue`: Caused by: org.neo4j.graphdb.config.InvalidSettingException: Bad value 'yes' for setting 'dbms.logs.query.enabled': must be 'true' or 'false'

To reset a config value to its default, pass an empty string as the value argument.

Example 3.7. Reset a config value to default
CALL dbms.setConfigValue('dbms.logs.query.enabled', '')

3.7.2. Dynamic settings reference

Table 3.5. Dynamic settings reference
Name Description


Limit the number of IOs the background checkpoint process will consume per second.


Log executed queries that take longer than the configured threshold, dbms.logs.query.threshold.


Maximum number of history files for the query log.


The file size in bytes at which the query log will auto-rotate.


If the execution of query takes more time than this threshold, the query is logged - provided query logging is enabled.


The maximum time interval of a transaction within which it should be completed.