Configuration settings

This section provides a complete reference to the Neo4j configuration settings.

Configuration settings can be set in neo4j.conf. Refer to The neo4j.conf file for details on how to use configuration settings.

Table 1. All settings
Name Description

browser.allow_outgoing_connections

Configure the policy for outgoing Neo4j Browser connections.

browser.credential_timeout

Configure the Neo4j Browser to time out logged in users after this idle period.

browser.post_connect_cmd

Commands to be run when Neo4j Browser successfully connects to this server.

browser.remote_content_hostname_whitelist

Whitelist of hosts for the Neo4j Browser to be allowed to fetch content from.

browser.retain_connection_credentials

Configure the Neo4j Browser to store or not store user credentials.

browser.retain_editor_history

Configure the Neo4j Browser to store or not store user editor history.

causal_clustering.catch_up_client_inactivity_timeout

The catch up protocol times out if the given duration elapses with no network activity.

causal_clustering.catchup_batch_size

The maximum batch size when catching up (in unit of entries).

causal_clustering.cluster_allow_reads_on_followers

Configure if the dbms.routing.getRoutingTable() procedure should include followers as read endpoints or return only read replicas.

causal_clustering.cluster_allow_reads_on_leader

Configure if the dbms.routing.getRoutingTable() procedure should include the leader as read endpoint or return only read replicas/followers.

causal_clustering.cluster_binding_timeout

The time allowed for a database on a Neo4j server to either join a cluster or form a new cluster with the other Neo4j Core Servers provided by causal_clustering.initial_discovery_members.

causal_clustering.cluster_topology_refresh

Time between scanning the cluster to refresh current server’s view of topology.

causal_clustering.command_applier_parallelism

Limits amount of global threads for applying commands.

causal_clustering.connect_randomly_to_server_group

Comma separated list of groups to be used by the connect-randomly-to-server-group selection strategy.

causal_clustering.discovery_advertised_address

Advertised cluster member discovery management communication.

causal_clustering.discovery_listen_address

Host and port to bind the cluster member discovery management communication.

causal_clustering.discovery_type

Configure the discovery type used for cluster name resolution.

causal_clustering.election_failure_detection_window

The rate at which leader elections happen.

causal_clustering.enable_pre_voting

Enable pre-voting extension to the Raft protocol (this is breaking and must match between the core cluster members).

causal_clustering.global_session_tracker_state_size

The maximum file size before the global session tracker state file is rotated (in unit of entries).

causal_clustering.handshake_timeout

Time out for protocol negotiation handshake.

causal_clustering.in_flight_cache.max_bytes

The maximum number of bytes in the in-flight cache.

causal_clustering.in_flight_cache.max_entries

The maximum number of entries in the in-flight cache.

causal_clustering.in_flight_cache.type

Type of in-flight cache.

causal_clustering.initial_discovery_members

A comma-separated list of other members of the cluster to join.

causal_clustering.join_catch_up_max_lag

Maximum amount of lag accepted for a new follower to join the Raft group.

causal_clustering.join_catch_up_timeout

Time out for a new member to catch up.

causal_clustering.kubernetes.address

Address for Kubernetes API.

causal_clustering.kubernetes.ca_crt

File location of CA certificate for Kubernetes API.

causal_clustering.kubernetes.cluster_domain

Kubernetes cluster domain.

causal_clustering.kubernetes.label_selector

LabelSelector for Kubernetes API.

causal_clustering.kubernetes.namespace

File location of namespace for Kubernetes API.

causal_clustering.kubernetes.service_port_name

Service port name for discovery for Kubernetes API.

causal_clustering.kubernetes.token

File location of token for Kubernetes API.

causal_clustering.last_applied_state_size

The maximum file size before the storage file is rotated (in unit of entries).

causal_clustering.leader_election_timeout

This setting is moved and enhanced into causal_clustering.leader_failure_detection_window and causal_clustering.election_failure_detection_window.

causal_clustering.leader_failure_detection_window

The time window within which the loss of the leader is detected and the first re-election attempt is held.The window should be significantly larger than typical communication delays to make conflicts unlikely.

causal_clustering.leadership_balancing

Which strategy to use when transferring database leaderships around a cluster.

causal_clustering.leadership_priority_group

The name of a server_group whose members should be prioritized as leaders.

causal_clustering.load_balancing.plugin

The load balancing plugin to use.

causal_clustering.load_balancing.shuffle

Enables shuffling of the returned load balancing result.

causal_clustering.log_shipping_max_lag

The maximum lag allowed before log shipping pauses (in unit of entries).

causal_clustering.log_shipping_retry_timeout

Retry time for log shipping to followers after a stall.

causal_clustering.max_raft_channels

The maximum number of TCP channels between two nodes to operate the raft protocol.Each database gets allocated one channel, but a single channel can be used by more than one database.

causal_clustering.middleware.logging.level

The level of middleware logging.

causal_clustering.minimum_core_cluster_size_at_formation

Minimum number of Core machines initially required to form a cluster.

causal_clustering.minimum_core_cluster_size_at_runtime

The minimum size of the dynamically adjusted voting set (which only core members may be a part of).

causal_clustering.multi_dc_license

Enable multi-data center features.

causal_clustering.protocol_implementations.catchup

Catchup protocol implementation versions that this instance will allow in negotiation as a comma-separated list.

causal_clustering.protocol_implementations.compression

Network compression algorithms that this instance will allow in negotiation as a comma-separated list.

causal_clustering.protocol_implementations.raft

Raft protocol implementation versions that this instance will allow in negotiation as a comma-separated list.

causal_clustering.pull_interval

Interval of pulling updates from cores.

causal_clustering.raft_advertised_address

Advertised hostname/IP address and port for the RAFT server.

causal_clustering.raft_handler_parallelism

Limits amount of global threads shared by raft groups for handling bathing of messages and timeout events.

causal_clustering.raft_in_queue_max_batch_bytes

Largest batch processed by RAFT in bytes.

causal_clustering.raft_in_queue_max_bytes

Maximum number of bytes in the RAFT in-queue.

causal_clustering.raft_listen_address

Network interface and port for the RAFT server to listen on.

causal_clustering.raft_log_implementation

RAFT log implementation.

causal_clustering.raft_log_prune_strategy

RAFT log pruning strategy.

causal_clustering.raft_log_pruning_frequency

RAFT log pruning frequency.

causal_clustering.raft_log_reader_pool_size

RAFT log reader pool size.

causal_clustering.raft_log_rotation_size

RAFT log rotation size.

causal_clustering.raft_membership_state_size

The maximum file size before the membership state file is rotated (in unit of entries).

causal_clustering.raft_term_state_size

The maximum file size before the term state file is rotated (in unit of entries).

causal_clustering.raft_vote_state_size

The maximum file size before the vote state file is rotated (in unit of entries).

causal_clustering.refuse_to_be_leader

Deprecated, use dbms.databases.default_to_read_only.

causal_clustering.replicated_lease_state_size

The maximum file size before the replicated lease state file is rotated (in unit of entries).

causal_clustering.replication_leader_await_timeout

The duration for which the replicator will await a new leader.

causal_clustering.replication_retry_timeout_base

The initial timeout until replication is retried.

causal_clustering.replication_retry_timeout_limit

The upper limit for the exponentially incremented retry timeout.

causal_clustering.server_groups

A list of group names for the server used when configuring load balancing and replication policies.

causal_clustering.state_machine_apply_max_batch_size

The maximum number of operations to be batched during applications of operations in the state machines.

causal_clustering.state_machine_flush_window_size

The number of operations to be processed before the state machines flush to disk.

causal_clustering.status_throughput_window

Sampling window for throughput estimate reported in the status endpoint.

causal_clustering.store_copy_chunk_size

Store copy chunk size.

causal_clustering.store_copy_max_retry_time_per_request

Maximum retry time per request during store copy.

causal_clustering.store_copy_parallelism

Limits amount of global threads for store copy.

causal_clustering.transaction_advertised_address

Advertised hostname/IP address and port for the transaction shipping server.

causal_clustering.transaction_listen_address

Network interface and port for the transaction shipping server to listen on.

causal_clustering.unknown_address_logging_throttle

Throttle limit for logging unknown cluster member address.

causal_clustering.upstream_selection_strategy

An ordered list in descending preference of the strategy which read replicas use to choose the upstream server from which to pull transactional updates.

causal_clustering.user_defined_upstream_strategy

Configuration of a user-defined upstream selection strategy.

cypher.default_language_version

Set this to specify the default parser (language version).

cypher.forbid_exhaustive_shortestpath

This setting is associated with performance optimization.

cypher.forbid_shortestpath_common_nodes

This setting is associated with performance optimization.

cypher.hints_error

Set this to specify the behavior when Cypher planner or runtime hints cannot be fulfilled.

cypher.lenient_create_relationship

Set this to change the behavior for Cypher create relationship when the start or end node is missing.

cypher.min_replan_interval

The minimum time between possible cypher query replanning events.

cypher.planner

Set this to specify the default planner for the default language version.

cypher.statistics_divergence_threshold

The threshold for statistics above which a plan is considered stale.

If any of the underlying statistics used to create the plan have changed more than this value, the plan will be considered stale and will be replanned.

db.temporal.timezone

Database timezone for temporal functions.

dbms.allow_single_automatic_upgrade

Whether to allow a system graph upgrade to happen automatically in single instance mode (dbms.mode=SINGLE).

dbms.allow_upgrade

Whether to allow a store upgrade in case the current version of the database starts against an older version of the store.

dbms.backup.enabled

Enable support for running online backups.

dbms.backup.incremental.strategy

Strategy for incremental backup.

dbms.backup.listen_address

Network interface and port for the backup server to listen on.

dbms.checkpoint

Configures the general policy for when check-points should occur.

dbms.checkpoint.interval.time

Configures the time interval between check-points.

dbms.checkpoint.interval.tx

Configures the transaction interval between check-points.

dbms.checkpoint.iops.limit

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

dbms.clustering.enable

Enable discovery service and a catchup server to be started on an Enterprise Standalone Instance 'dbms.mode=SINGLE', and with that allow for Read Replicas to connect and pull transaction from it.

dbms.config.strict_validation

A strict configuration validation will prevent the database from starting up if unknown configuration options are specified in the neo4j settings namespace (such as dbms., cypher., etc).

dbms.connector.bolt.advertised_address

Advertised address for this connector.

dbms.connector.bolt.enabled

Enable the bolt connector.

dbms.connector.bolt.listen_address

Address the connector should bind to.

dbms.connector.bolt.ocsp_stapling_enabled

Enable server OCSP stapling for bolt and http connectors.

dbms.connector.bolt.thread_pool_keep_alive

The maximum time an idle thread in the thread pool bound to this connector will wait for new tasks.

dbms.connector.bolt.thread_pool_max_size

The maximum number of threads allowed in the thread pool bound to this connector.

dbms.connector.bolt.thread_pool_min_size

The number of threads to keep in the thread pool bound to this connector, even if they are idle.

dbms.connector.bolt.tls_level

Encryption level to require this connector to use.

dbms.connector.bolt.unsupported_thread_pool_shutdown_wait_time

The maximum time to wait for the thread pool to finish processing its pending jobs and shutdown.

dbms.connector.http.advertised_address

Advertised address for this connector.

dbms.connector.http.enabled

Enable the http connector.

dbms.connector.http.listen_address

Address the connector should bind to.

dbms.connector.https.advertised_address

Advertised address for this connector.

dbms.connector.https.enabled

Enable the https connector.

dbms.connector.https.listen_address

Address the connector should bind to.

dbms.databases.default_to_read_only

Whether or not any database on this instance are read_only by default.

dbms.databases.read_only

List of databases for which to prevent write queries.

dbms.databases.writable

List of databases for which to allow write queries.

dbms.db.timezone

Database timezone.

dbms.default_advertised_address

Default hostname or IP address the server uses to advertise itself.

dbms.default_database

Name of the default database.

dbms.default_listen_address

Default network interface to listen for incoming connections.

dbms.directories.cluster_state

Directory to hold cluster state including Raft log.

dbms.directories.data

Path of the data directory.

dbms.directories.dumps.root

Root location where Neo4j will store database dumps optionally produced when dropping said databases.

dbms.directories.import

Sets the root directory for file URLs used with the Cypher LOAD CSV clause.

dbms.directories.lib

Path of the lib directory.

dbms.directories.licenses

Path of the licenses directory.

dbms.directories.logs

Path of the logs directory.

dbms.directories.metrics

The target location of the CSV files: a path to a directory wherein a CSV file per reported field will be written.

dbms.directories.neo4j_home

Root relative to which directory settings are resolved.

dbms.directories.plugins

Location of the database plugin directory.

dbms.directories.run

Path of the run directory.

dbms.directories.script.root

Root location where Neo4j will store scripts for configured databases.

dbms.directories.transaction.logs.root

Root location where Neo4j will store transaction logs for configured databases.

dbms.dynamic.setting.allowlist

A list of setting name patterns (comma separated) that are allowed to be dynamically changed.

dbms.dynamic.setting.whitelist

A list of setting name patterns (comma separated) that are allowed to be dynamically changed.

dbms.filewatcher.enabled

Allows the enabling or disabling of the file watcher service.

dbms.http_enabled_modules

Defines the set of modules loaded into the Neo4j web server.

dbms.import.csv.buffer_size

The size of the internal buffer in bytes used by LOAD CSV.

dbms.import.csv.legacy_quote_escaping

Selects whether to conform to the standard https://tools.ietf.org/html/rfc4180 for interpreting escaped quotation characters in CSV files loaded using LOAD CSV.

dbms.index.default_schema_provider

Index provider to use for newly created schema indexes.

dbms.index.fulltext.default_analyzer

The name of the analyzer that the fulltext indexes should use by default.

dbms.index.fulltext.eventually_consistent

Whether or not fulltext indexes should be eventually consistent by default or not.

dbms.index.fulltext.eventually_consistent_index_update_queue_max_length

The eventually_consistent mode of the fulltext indexes works by queueing up index updates to be applied later in a background thread.

dbms.index_sampling.background_enabled

Enable or disable background index sampling.

dbms.index_sampling.sample_size_limit

Index sampling chunk size limit.

dbms.index_sampling.update_percentage

Percentage of index updates of total index size required before sampling of a given index is triggered.

dbms.index_searcher_cache_size

The maximum number of open Lucene index searchers.

dbms.jvm.additional

Additional JVM arguments.

dbms.lock.acquisition.timeout

The maximum time interval within which lock should be acquired.

dbms.logs.debug.format

Log format to use for debug log.

dbms.logs.debug.level

Debug log level threshold.

dbms.logs.debug.path

Path to the debug log file.

dbms.logs.debug.rotation.delay

Minimum time interval after last rotation of the debug log before it may be rotated again.

dbms.logs.debug.rotation.keep_number

Maximum number of history files for the debug log.

dbms.logs.debug.rotation.size

Threshold for rotation of the debug log.

dbms.logs.default_format

Default log format.

dbms.logs.gc.enabled

Enable GC Logging.

dbms.logs.gc.options

GC Logging Options.

dbms.logs.gc.rotation.keep_number

Number of GC logs to keep.

dbms.logs.gc.rotation.size

Size of each GC log that is kept.

dbms.logs.http.enabled

Enable HTTP request logging.

dbms.logs.http.path

Path to HTTP request log.

dbms.logs.http.rotation.keep_number

Number of HTTP logs to keep.

dbms.logs.http.rotation.size

Size of each HTTP log that is kept.

dbms.logs.query.allocation_logging_enabled

Log allocated bytes for the executed queries being logged.

dbms.logs.query.early_raw_logging_enabled

Log query text and parameters without obfuscating passwords.

dbms.logs.query.enabled

Log executed queries.

dbms.logs.query.format

Log format to use for the query log.

dbms.logs.query.max_parameter_length

Sets a maximum character length use for each parameter in the log.

dbms.logs.query.obfuscate_literals

Obfuscates all literals of the query before writing to the log.

dbms.logs.query.page_logging_enabled

Log page hits and page faults for the executed queries being logged.

dbms.logs.query.parameter_full_entities

Log complete parameter entities including id, labels or relationship type, and properties.

dbms.logs.query.parameter_logging_enabled

Log parameters for the executed queries being logged.

dbms.logs.query.path

Path to the query log file.

dbms.logs.query.plan_description_enabled

Log query plan description table, useful for debugging purposes.

dbms.logs.query.rotation.keep_number

Maximum number of history files for the query log.

dbms.logs.query.rotation.size

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

dbms.logs.query.runtime_logging_enabled

Logs which runtime that was used to run the query.

dbms.logs.query.threshold

If the execution of query takes more time than this threshold, the query is logged once completed - provided query logging is set to INFO.

dbms.logs.query.time_logging_enabled

Log detailed time information for the executed queries being logged.

dbms.logs.query.transaction.enabled

Log the start and end of a transaction.

dbms.logs.query.transaction.threshold

If the transaction is open for more time than this threshold, the transaction is logged once completed - provided transaction logging (dbms.logs.query.transaction.enabled) is set to INFO.

dbms.logs.query.transaction_id.enabled

Log transaction ID for the executed queries.

dbms.logs.security.format

Log format to use for security log.

dbms.logs.security.level

Security log level threshold.

dbms.logs.security.path

Path to the security log file.

dbms.logs.security.rotation.delay

Minimum time interval after last rotation of the security log before it may be rotated again.

dbms.logs.security.rotation.keep_number

Maximum number of history files for the security log.

dbms.logs.security.rotation.size

Threshold for rotation of the security log.

dbms.logs.user.format

Log format to use for user log.

dbms.logs.user.path

Path to the user log file.

dbms.logs.user.rotation.delay

Minimum time interval after last rotation of the user log (neo4j.log) before it may be rotated again.

dbms.logs.user.rotation.keep_number

Maximum number of history files for the user log (neo4j.log).

dbms.logs.user.rotation.size

Threshold for rotation of the user log (neo4j.log).

dbms.logs.user.stdout_enabled

Send user logs to the process stdout.

dbms.max_databases

The maximum number of databases.

dbms.memory.heap.initial_size

Initial heap size.

dbms.memory.heap.max_size

Maximum heap size.

dbms.memory.off_heap.block_cache_size

Defines the size of the off-heap memory blocks cache.

dbms.memory.off_heap.max_cacheable_block_size

Defines the maximum size of an off-heap memory block that can be cached to speed up allocations.

dbms.memory.off_heap.max_size

The maximum amount of off-heap memory that can be used to store transaction state data; it’s a total amount of memory shared across all active transactions.

dbms.memory.pagecache.directio

Use direct I/O for page cache.

dbms.memory.pagecache.flush.buffer.enabled

Page cache can be configured to use a temporal buffer for flushing purposes.

dbms.memory.pagecache.flush.buffer.size_in_pages

Page cache can be configured to use a temporal buffer for flushing purposes.

dbms.memory.pagecache.scan.prefetchers

The maximum number of worker threads to use for pre-fetching data when doing sequential scans.

dbms.memory.pagecache.size

The amount of memory to use for mapping the store files, in bytes (or kilobytes with the 'k' suffix, megabytes with 'm' and gigabytes with 'g').

dbms.memory.pagecache.swapper

This setting is not used anymore.

dbms.memory.pagecache.warmup.enable

Page cache can be configured to perform usage sampling of loaded pages that can be used to construct active load profile.

dbms.memory.pagecache.warmup.preload

Page cache warmup can be configured to prefetch files, preferably when cache size is bigger than store size.

dbms.memory.pagecache.warmup.preload.allowlist

Page cache warmup prefetch file allowlist regex.

dbms.memory.pagecache.warmup.preload.whitelist

Page cache warmup prefetch file whitelist regex.

dbms.memory.pagecache.warmup.profile.interval

The profiling frequency for the page cache.

dbms.memory.tracking.enable

Enable off heap and on heap memory tracking.

dbms.memory.transaction.database_max_size

Limit the amount of memory that all transactions in one database can consume, in bytes (or kilobytes with the 'k' suffix, megabytes with 'm' and gigabytes with 'g').

dbms.memory.transaction.global_max_size

Limit the amount of memory that all of the running transactions can consume, in bytes (or kilobytes with the 'k' suffix, megabytes with 'm' and gigabytes with 'g').

dbms.memory.transaction.max_size

Limit the amount of memory that a single transaction can consume, in bytes (or kilobytes with the 'k' suffix, megabytes with 'm' and gigabytes with 'g').

dbms.mode

Configure the operating mode of the database — 'SINGLE' for stand-alone operation, 'CORE' for operating as a core member of a Causal Cluster, or 'READ_REPLICA' for operating as a read replica member of a Causal Cluster.

dbms.netty.ssl.provider

Netty SSL provider.

dbms.panic.shutdown_on_panic

If there is a Database Management System Panic (an irrecoverable error) should the neo4j process shut down or continue running.

dbms.query_cache_size

The number of Cypher query execution plans that are cached.

dbms.read_only

Only allow read operations from this Neo4j instance.

dbms.reconciler.max_backoff

Defines the maximum amount of time to wait before retrying after the dbms fails to reconcile a database to its desired state.

dbms.reconciler.max_parallelism

Defines the level of parallelism employed by the reconciler.

dbms.reconciler.may_retry

Defines whether the dbms may retry reconciling a database to its desired state.

dbms.reconciler.min_backoff

Defines the minimum amount of time to wait before retrying after the dbms fails to reconcile a database to its desired state.

dbms.record_format

Database record format.

dbms.recovery.fail_on_missing_files

If true, Neo4j will abort recovery if transaction log files are missing.

dbms.relationship_grouping_threshold

Relationship count threshold for considering a node to be dense.

dbms.rest.transaction.idle_timeout

Timeout for idle transactions in the REST endpoint.

dbms.routing.advertised_address

The advertised address for the intra-cluster routing connector.

dbms.routing.client_side.enforce_for_domains

Always use client side routing (regardless of the default router) for neo4j:// protocol connections to these domains.

dbms.routing.default_router

Use server side routing by default for neo4j:// protocol connections.

dbms.routing.driver.api

Determines which driver API will be used.

dbms.routing.driver.connection.connect_timeout

Socket connection timeout. A timeout of zero is treated as an infinite timeout and will be bound by the timeout configured on the operating system level.

dbms.routing.driver.connection.max_lifetime

Pooled connections older than this threshold will be closed and removed from the pool. Setting this option to a low value will cause a high connection churn and might result in a performance hit. It is recommended to set maximum lifetime to a slightly smaller value than the one configured in network equipment (load balancer, proxy, firewall, etc.

dbms.routing.driver.connection.pool.acquisition_timeout

Maximum amount of time spent attempting to acquire a connection from the connection pool. This timeout only kicks in when all existing connections are being used and no new connections can be created because maximum connection pool size has been reached. Error is raised when connection can’t be acquired within configured time. Negative values are allowed and result in unlimited acquisition timeout.

dbms.routing.driver.connection.pool.idle_test

Pooled connections that have been idle in the pool for longer than this timeout will be tested before they are used again, to ensure they are still alive. If this option is set too low, an additional network call will be incurred when acquiring a connection, which causes a performance hit. If this is set high, no longer live connections might be used which might lead to errors. Hence, this parameter tunes a balance between the likelihood of experiencing connection problems and performance Normally, this parameter should not need tuning. Value 0 means connections will always be tested for validity.

dbms.routing.driver.connection.pool.max_size

Maximum total number of connections to be managed by a connection pool. The limit is enforced for a combination of a host and user.

dbms.routing.driver.logging.level

Sets level for driver internal logging.

dbms.routing.enabled

Enable intra-cluster routing using an additional bolt connector.

dbms.routing.listen_address

The address the routing connector should bind to.

dbms.routing_ttl

How long callers should cache the response of the routing procedure dbms.routing.getRoutingTable().

dbms.security.allow_csv_import_from_file_urls

Determines if Cypher will allow using file URLs when loading data using LOAD CSV.

dbms.security.auth_cache_max_capacity

The maximum capacity for authentication and authorization caches (respectively).

dbms.security.auth_cache_ttl

The time to live (TTL) for cached authentication and authorization info when using external auth providers (LDAP or plugin).

dbms.security.auth_cache_use_ttl

Enable time-based eviction of the authentication and authorization info cache for external auth providers (LDAP or plugin).

dbms.security.auth_enabled

Enable auth requirement to access Neo4j.

dbms.security.auth_lock_time

The amount of time user account should be locked after a configured number of unsuccessful authentication attempts.

dbms.security.auth_max_failed_attempts

The maximum number of unsuccessful authentication attempts before imposing a user lock for the configured amount of time, as defined by dbms.security.auth_lock_time.The locked out user will not be able to log in until the lock period expires, even if correct credentials are provided.

dbms.security.authentication_providers

A list of security authentication providers containing the users and roles.

dbms.security.authorization_providers

A list of security authorization providers containing the users and roles.

dbms.security.causal_clustering_status_auth_enabled

Require authorization for access to the Causal Clustering status endpoints.

dbms.security.http_access_control_allow_origin

Value of the Access-Control-Allow-Origin header sent over any HTTP or HTTPS connector.

dbms.security.http_auth_allowlist

Defines an allowlist of http paths where Neo4j authentication is not required.

dbms.security.http_auth_whitelist

Defines a whitelist of http paths where Neo4j authentication is not required.

dbms.security.http_strict_transport_security

Value of the HTTP Strict-Transport-Security (HSTS) response header.

dbms.security.ldap.authentication.attribute

The attribute to use when looking up users. Using this setting requires dbms.security.ldap.authentication.search_for_attribute to be true and thus dbms.security.ldap.authorization.system_username and dbms.security.ldap.authorization.system_password to be configured.

dbms.security.ldap.authentication.cache_enabled

Determines if the result of authentication via the LDAP server should be cached or not.

dbms.security.ldap.authentication.mechanism

LDAP authentication mechanism.

dbms.security.ldap.authentication.search_for_attribute

Perform authentication by searching for an unique attribute of a user. Using this setting requires dbms.security.ldap.authorization.system_username and dbms.security.ldap.authorization.system_password to be configured.

dbms.security.ldap.authentication.use_samaccountname

Perform authentication by searching for an unique attribute of a user. This setting is deprecated and has been replaced with dbms.security.ldap.authentication.search_for_attribute.

dbms.security.ldap.authentication.user_dn_template

LDAP user DN template.

dbms.security.ldap.authorization.access_permitted_group

The LDAP group to which a user must belong to get any access to the system.Set this to restrict access to a subset of LDAP users belonging to a particular group.

dbms.security.ldap.authorization.group_membership_attributes

A list of attribute names on a user object that contains groups to be used for mapping to roles when LDAP authorization is enabled.

dbms.security.ldap.authorization.group_to_role_mapping

An authorization mapping from LDAP group names to Neo4j role names.

dbms.security.ldap.authorization.system_password

An LDAP system account password to use for authorization searches when dbms.security.ldap.authorization.use_system_account is true.

dbms.security.ldap.authorization.system_username

An LDAP system account username to use for authorization searches when dbms.security.ldap.authorization.use_system_account is true.

dbms.security.ldap.authorization.use_system_account

Perform LDAP search for authorization info using a system account instead of the user’s own account. If this is set to false (default), the search for group membership will be performed directly after authentication using the LDAP context bound with the user’s own account.

dbms.security.ldap.authorization.user_search_base

The name of the base object or named context to search for user objects when LDAP authorization is enabled.

dbms.security.ldap.authorization.user_search_filter

The LDAP search filter to search for a user principal when LDAP authorization is enabled.

dbms.security.ldap.connection_timeout

The timeout for establishing an LDAP connection.

dbms.security.ldap.host

URL of LDAP server to use for authentication and authorization.

dbms.security.ldap.read_timeout

The timeout for an LDAP read request (i.e.

dbms.security.ldap.referral

The LDAP referral behavior when creating a connection.

dbms.security.ldap.use_starttls

Use secure communication with the LDAP server using opportunistic TLS.

dbms.security.log_successful_authentication

Set to log successful authentication events to the security log.

dbms.security.procedures.allowlist

A list of procedures (comma separated) that are to be loaded.

dbms.security.procedures.default_allowed

The default role that can execute all procedures and user-defined functions that are not covered by the dbms.security.procedures.roles setting.

dbms.security.procedures.roles

This provides a finer level of control over which roles can execute procedures than the dbms.security.procedures.default_allowed setting.

dbms.security.procedures.unrestricted

A list of procedures and user defined functions (comma separated) that are allowed full access to the database.

dbms.security.procedures.whitelist

A list of procedures (comma separated) that are to be loaded.

dbms.shutdown_transaction_end_timeout

The maximum amount of time to wait for running transactions to complete before allowing initiated database shutdown to continue.

dbms.store.files.preallocate

Specify if Neo4j should try to preallocate store files as they grow.

dbms.threads.worker_count

Number of Neo4j worker threads.

dbms.track_query_allocation

Enables or disables tracking of how many bytes are allocated by the execution of a query.

dbms.track_query_cpu_time

Enables or disables tracking of how much time a query spends actively executing on the CPU.

dbms.transaction.bookmark_ready_timeout

The maximum amount of time to wait for the database state represented by the bookmark.

dbms.transaction.concurrent.maximum

The maximum number of concurrently running transactions.

dbms.transaction.monitor.check.interval

Configures the time interval between transaction monitor checks.

dbms.transaction.sampling.percentage

Transaction sampling percentage.

dbms.transaction.timeout

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

dbms.transaction.tracing.level

Transaction creation tracing level.

dbms.tx_log.preallocate

Specify if Neo4j should try to preallocate logical log file in advance.

dbms.tx_log.rotation.retention_policy

Tell Neo4j how long logical transaction logs should be kept to backup the database.For example, "10 days" will prune logical logs that only contain transactions older than 10 days.Alternatively, "100k txs" will keep the 100k latest transactions from each database and prune any older transactions.

dbms.tx_log.rotation.size

Specifies at which file size the logical log will auto-rotate.

dbms.tx_state.memory_allocation

Defines whether memory for transaction state should be allocated on- or off-heap.

dbms.unmanaged_extension_classes

Comma-separated list of <classname>=<mount point> for unmanaged extensions.

dbms.upgrade_max_processors

Max number of processors used when upgrading the store.

dbms.windows_service_name

Name of the Windows Service.

fabric.database.name

Name of the Fabric database.

fabric.driver.api

Determines which driver API will be used.

fabric.driver.connection.connect_timeout

Socket connection timeout. A timeout of zero is treated as an infinite timeout and will be bound by the timeout configured on the operating system level.

fabric.driver.connection.max_lifetime

Pooled connections older than this threshold will be closed and removed from the pool. Setting this option to a low value will cause a high connection churn and might result in a performance hit. It is recommended to set maximum lifetime to a slightly smaller value than the one configured in network equipment (load balancer, proxy, firewall, etc.

fabric.driver.connection.pool.acquisition_timeout

Maximum amount of time spent attempting to acquire a connection from the connection pool. This timeout only kicks in when all existing connections are being used and no new connections can be created because maximum connection pool size has been reached. Error is raised when connection can’t be acquired within configured time. Negative values are allowed and result in unlimited acquisition timeout.

fabric.driver.connection.pool.idle_test

Pooled connections that have been idle in the pool for longer than this timeout will be tested before they are used again, to ensure they are still alive. If this option is set too low, an additional network call will be incurred when acquiring a connection, which causes a performance hit. If this is set high, no longer live connections might be used which might lead to errors. Hence, this parameter tunes a balance between the likelihood of experiencing connection problems and performance Normally, this parameter should not need tuning. Value 0 means connections will always be tested for validity.

fabric.driver.connection.pool.max_size

Maximum total number of connections to be managed by a connection pool. The limit is enforced for a combination of a host and user.

fabric.driver.logging.level

Sets level for driver internal logging.

fabric.routing.servers

A comma-separated list of Fabric instances that form a routing group.

fabric.routing.ttl

The time to live (TTL) of a routing table for fabric routing group.

fabric.stream.buffer.low_watermark

Number of records in prefetching buffer that will trigger prefetching again.

fabric.stream.buffer.size

Maximal size of a buffer used for pre-fetching result records of remote queries. To compensate for latency to remote databases, the Fabric execution engine pre-fetches records needed for local executions. This limit is enforced per fabric query.

fabric.stream.concurrency

Maximal concurrency within Fabric queries. Limits the number of iterations of each subquery that are executed concurrently.

metrics.bolt.messages.enabled

Enable reporting metrics about Bolt Protocol message processing.

metrics.csv.enabled

Set to true to enable exporting metrics to CSV files.

metrics.csv.interval

The reporting interval for the CSV files.

metrics.csv.rotation.compression

Decides what compression to use for the csv history files.

metrics.csv.rotation.keep_number

Maximum number of history files for the csv files.

metrics.csv.rotation.size

The file size in bytes at which the csv files will auto-rotate.

metrics.cypher.replanning.enabled

Enable reporting metrics about number of occurred replanning events.

metrics.enabled

Enable metrics.

metrics.filter

Specifies which metrics should be enabled by using a comma separated list of globbing patterns.

metrics.graphite.enabled

Set to true to enable exporting metrics to Graphite.

metrics.graphite.interval

The reporting interval for Graphite.

metrics.graphite.server

The hostname or IP address of the Graphite server.

metrics.jmx.enabled

Set to true to enable the JMX metrics endpoint.

metrics.jvm.buffers.enabled

Enable reporting metrics about the buffer pools.

metrics.jvm.file.descriptors.enabled

Enable reporting metrics about the number of open file descriptors.

metrics.jvm.gc.enabled

Enable reporting metrics about the duration of garbage collections.

metrics.jvm.heap.enabled

Enable reporting metrics about the heap memory usage.

metrics.jvm.memory.enabled

Enable reporting metrics about the memory usage.

metrics.jvm.pause_time.enabled

Enable reporting metrics about the VM pause time.

metrics.jvm.threads.enabled

Enable reporting metrics about the current number of threads running.

metrics.namespaces.enabled

Enable metrics namespaces that separates the global and database specific metrics.

metrics.neo4j.causal_clustering.enabled

Enable reporting metrics about Causal Clustering mode.

metrics.neo4j.checkpointing.enabled

Enable reporting metrics about Neo4j check pointing; when it occurs and how much time it takes to complete.

metrics.neo4j.counts.enabled

Enable reporting metrics about approximately how many entities are in the database; nodes, relationships, properties, etc.

metrics.neo4j.data.counts.enabled

Enable reporting metrics about number of entities in the database.

metrics.neo4j.database_operation_count.enabled

Enable reporting metrics for Neo4j dbms operations; how many times databases have been created, started, stopped or dropped, and how many attempted operations have failed and recovered later.

metrics.neo4j.logs.enabled

Enable reporting metrics about the Neo4j transaction logs.

metrics.neo4j.pagecache.enabled

Enable reporting metrics about the Neo4j page cache; page faults, evictions, flushes, exceptions, etc.

metrics.neo4j.pools.enabled

Enable reporting metrics about Neo4j memory pools.

metrics.neo4j.server.enabled

Enable reporting metrics about Server threading info.

metrics.neo4j.size.enabled

Enable reporting metrics about the store size of each database.

metrics.neo4j.tx.enabled

Enable reporting metrics about transactions; number of transactions started, committed, etc.

metrics.prefix

A common prefix for the reported metrics field names.

metrics.prometheus.enabled

Set to true to enable the Prometheus endpoint.

metrics.prometheus.endpoint

The hostname and port to use as Prometheus endpoint.

Table 2. browser.allow_outgoing_connections

Description

Configure the policy for outgoing Neo4j Browser connections.

Valid values

browser.allow_outgoing_connections, a boolean

Default value

true

Table 3. browser.credential_timeout

Description

Configure the Neo4j Browser to time out logged in users after this idle period. Setting this to 0 indicates no limit.

Valid values

browser.credential_timeout, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

0s

Table 4. browser.post_connect_cmd

Description

Commands to be run when Neo4j Browser successfully connects to this server. Separate multiple commands with semi-colon.

Valid values

browser.post_connect_cmd, a string

Default value

Table 5. browser.remote_content_hostname_whitelist

Description

Whitelist of hosts for the Neo4j Browser to be allowed to fetch content from.

Valid values

browser.remote_content_hostname_whitelist, a string

Default value

guides.neo4j.com,localhost

Table 6. browser.retain_connection_credentials

Description

Configure the Neo4j Browser to store or not store user credentials.

Valid values

browser.retain_connection_credentials, a boolean

Default value

true

Table 7. browser.retain_editor_history

Description

Configure the Neo4j Browser to store or not store user editor history.

Valid values

browser.retain_editor_history, a boolean

Default value

true

Table 8. causal_clustering.catch_up_client_inactivity_timeout

Description

The catch up protocol times out if the given duration elapses with no network activity. Every message received by the client from the server extends the time out duration.

Valid values

causal_clustering.catch_up_client_inactivity_timeout, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

10m

Table 9. causal_clustering.catchup_batch_size

Description

The maximum batch size when catching up (in unit of entries)

Valid values

causal_clustering.catchup_batch_size, an integer

Default value

64

Table 10. causal_clustering.cluster_allow_reads_on_followers

Description

Configure if the dbms.routing.getRoutingTable() procedure should include followers as read endpoints or return only read replicas. Note: if there are no read replicas in the cluster, followers are returned as read end points regardless the value of this setting. Defaults to true so that followers are available for read-only queries in a typical heterogeneous setup.

Valid values

causal_clustering.cluster_allow_reads_on_followers, a boolean

Default value

true

Table 11. causal_clustering.cluster_allow_reads_on_leader

Description

Configure if the dbms.routing.getRoutingTable() procedure should include the leader as read endpoint or return only read replicas/followers. Note: leader is returned as read endpoint if no other member is present all.

Valid values

causal_clustering.cluster_allow_reads_on_leader, a boolean

Dynamic

true

Default value

false

Table 12. causal_clustering.cluster_binding_timeout

Description

The time allowed for a database on a Neo4j server to either join a cluster or form a new cluster with the other Neo4j Core Servers provided by causal_clustering.initial_discovery_members.

Valid values

causal_clustering.cluster_binding_timeout, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

5m

Table 13. causal_clustering.cluster_topology_refresh

Description

Time between scanning the cluster to refresh current server’s view of topology.

Valid values

causal_clustering.cluster_topology_refresh, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's') which is minimum 1s

Default value

5s

Table 14. causal_clustering.command_applier_parallelism

Description

Limits amount of global threads for applying commands.

Valid values

causal_clustering.command_applier_parallelism, an integer which is minimum 1

Default value

8

Table 15. causal_clustering.connect_randomly_to_server_group

Description

Comma separated list of groups to be used by the connect-randomly-to-server-group selection strategy. The connect-randomly-to-server-group strategy is used if the list of strategies (causal_clustering.upstream_selection_strategy) includes the value connect-randomly-to-server-group.

Valid values

causal_clustering.connect_randomly_to_server_group, a ',' separated list with elements of type 'a string identifying a Server Group'.

Dynamic

true

Default value

Table 16. causal_clustering.discovery_advertised_address

Description

Advertised cluster member discovery management communication.

Valid values

causal_clustering.discovery_advertised_address, a socket address. If missing port or hostname it is acquired from dbms.default_advertised_address

Default value

:5000

Table 17. causal_clustering.discovery_listen_address

Description

Host and port to bind the cluster member discovery management communication.

Valid values

causal_clustering.discovery_listen_address, a socket address. If missing port or hostname it is acquired from dbms.default_listen_address

Default value

:5000

Table 18. causal_clustering.discovery_type

Description

Configure the discovery type used for cluster name resolution.

Valid values

causal_clustering.discovery_type, one of [DNS, LIST, SRV, K8S] which depends on dbms.mode. If dbms.mode is CORE or is READ_REPLICA then it may require different settings depending on the discovery type: DNS requires [causal_clustering.initial_discovery_members], LIST requires [causal_clustering.initial_discovery_members], SRV requires [causal_clustering.initial_discovery_members], K8S requires [causal_clustering.kubernetes.label_selector, causal_clustering.kubernetes.service_port_name] otherwise it depends on dbms.clustering.enable. If dbms.clustering.enable is true then it may require different settings depending on the discovery type: DNS requires [causal_clustering.initial_discovery_members], LIST requires [causal_clustering.initial_discovery_members], SRV requires [causal_clustering.initial_discovery_members], K8S requires [causal_clustering.kubernetes.label_selector, causal_clustering.kubernetes.service_port_name] otherwise it is unconstrained..

Default value

LIST

Table 19. causal_clustering.election_failure_detection_window

Description

The rate at which leader elections happen. Note that due to election conflicts it might take several attempts to find a leader. The window should be significantly larger than typical communication delays to make conflicts unlikely.

Valid values

causal_clustering.election_failure_detection_window, a duration-range <min-max> (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

3s-6s

Table 20. causal_clustering.enable_pre_voting

Description

Enable pre-voting extension to the Raft protocol (this is breaking and must match between the core cluster members)

Valid values

causal_clustering.enable_pre_voting, a boolean

Default value

true

Table 21. causal_clustering.global_session_tracker_state_size

Description

The maximum file size before the global session tracker state file is rotated (in unit of entries)

Valid values

causal_clustering.global_session_tracker_state_size, an integer

Default value

1000

Table 22. causal_clustering.handshake_timeout

Description

Time out for protocol negotiation handshake.

Valid values

causal_clustering.handshake_timeout, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

20s

Table 23. causal_clustering.in_flight_cache.max_bytes

Description

The maximum number of bytes in the in-flight cache.

Valid values

causal_clustering.in_flight_cache.max_bytes, a byte size (valid multipliers are B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB)

Default value

2.00GiB

Table 24. causal_clustering.in_flight_cache.max_entries

Description

The maximum number of entries in the in-flight cache.

Valid values

causal_clustering.in_flight_cache.max_entries, an integer

Default value

1024

Table 25. causal_clustering.in_flight_cache.type

Description

Type of in-flight cache.

Valid values

causal_clustering.in_flight_cache.type, one of [NONE, CONSECUTIVE, UNBOUNDED]

Default value

CONSECUTIVE

Table 26. causal_clustering.initial_discovery_members

Description

A comma-separated list of other members of the cluster to join.

Valid values

causal_clustering.initial_discovery_members, a ',' separated list with elements of type 'a socket address'.

Table 27. causal_clustering.join_catch_up_max_lag

Description

Maximum amount of lag accepted for a new follower to join the Raft group.

Valid values

causal_clustering.join_catch_up_max_lag, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

10s

Table 28. causal_clustering.join_catch_up_timeout

Description

Time out for a new member to catch up.

Valid values

causal_clustering.join_catch_up_timeout, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

10m

Table 29. causal_clustering.kubernetes.address

Description

Address for Kubernetes API.

Valid values

causal_clustering.kubernetes.address, a socket address

Default value

kubernetes.default.svc:443

Table 30. causal_clustering.kubernetes.ca_crt

Description

File location of CA certificate for Kubernetes API.

Valid values

causal_clustering.kubernetes.ca_crt, a path

Default value

/var/run/secrets/kubernetes.io/serviceaccount/ca.crt

Table 31. causal_clustering.kubernetes.cluster_domain

Description

Kubernetes cluster domain.

Valid values

causal_clustering.kubernetes.cluster_domain, a string

Default value

cluster.local

Table 32. causal_clustering.kubernetes.label_selector

Description

LabelSelector for Kubernetes API.

Valid values

causal_clustering.kubernetes.label_selector, a string

Table 33. causal_clustering.kubernetes.namespace

Description

File location of namespace for Kubernetes API.

Valid values

causal_clustering.kubernetes.namespace, a path

Default value

/var/run/secrets/kubernetes.io/serviceaccount/namespace

Table 34. causal_clustering.kubernetes.service_port_name

Description

Service port name for discovery for Kubernetes API.

Valid values

causal_clustering.kubernetes.service_port_name, a string

Table 35. causal_clustering.kubernetes.token

Description

File location of token for Kubernetes API.

Valid values

causal_clustering.kubernetes.token, a path

Default value

/var/run/secrets/kubernetes.io/serviceaccount/token

Table 36. causal_clustering.last_applied_state_size

Description

The maximum file size before the storage file is rotated (in unit of entries)

Valid values

causal_clustering.last_applied_state_size, an integer

Default value

1000

Table 37. causal_clustering.leader_election_timeout

Description

Valid values

causal_clustering.leader_election_timeout, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

7s

Deprecated

The causal_clustering.leader_election_timeout configuration setting has been deprecated.

Table 38. causal_clustering.leader_failure_detection_window

Description

The time window within which the loss of the leader is detected and the first re-election attempt is held.The window should be significantly larger than typical communication delays to make conflicts unlikely.

Valid values

causal_clustering.leader_failure_detection_window, a duration-range <min-max> (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

20s-23s

Table 39. causal_clustering.leadership_balancing

Description

Which strategy to use when transferring database leaderships around a cluster. This can be one of equal_balancing or no_balancing. equal_balancing automatically ensures that each Core server holds the leader role for an equal number of databases.no_balancing prevents any automatic balancing of the leader role.Note that if a leadership_priority_group is specified for a given database, the value of this setting will be ignored for that database.

Valid values

causal_clustering.leadership_balancing, one of [NO_BALANCING, EQUAL_BALANCING]

Default value

EQUAL_BALANCING

Table 40. causal_clustering.leadership_priority_group

Description

The name of a server_group whose members should be prioritized as leaders. This does not guarantee that members of this group will be leader at all times, but the cluster will attempt to transfer leadership to such a member when possible. If a database is specified using causal_clustering.leadership_priority_group.<database> the specified priority group will apply to that database only. If no database is specified that group will be the default and apply to all databases which have no priority group explicitly set. Using this setting will disable leadership balancing.

Valid values

causal_clustering.leadership_priority_group, a string identifying a Server Group

Default value

Table 41. causal_clustering.load_balancing.plugin

Description

The load balancing plugin to use.

Valid values

causal_clustering.load_balancing.plugin, a string which depends on dbms.mode. If dbms.mode is CORE then it specified load balancer plugin exist. otherwise it is unconstrained.

Default value

server_policies

Table 42. causal_clustering.load_balancing.shuffle

Description

Enables shuffling of the returned load balancing result.

Valid values

causal_clustering.load_balancing.shuffle, a boolean

Default value

true

Table 43. causal_clustering.log_shipping_max_lag

Description

The maximum lag allowed before log shipping pauses (in unit of entries)

Valid values

causal_clustering.log_shipping_max_lag, an integer

Default value

256

Table 44. causal_clustering.log_shipping_retry_timeout

Description

Retry time for log shipping to followers after a stall.

Valid values

causal_clustering.log_shipping_retry_timeout, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

5s

Table 45. causal_clustering.max_raft_channels

Description

The maximum number of TCP channels between two nodes to operate the raft protocol.Each database gets allocated one channel, but a single channel can be used by more than one database.

Valid values

causal_clustering.max_raft_channels, an integer

Default value

8

Table 46. causal_clustering.middleware.logging.level

Description

The level of middleware logging.

Valid values

causal_clustering.middleware.logging.level, one of [DEBUG, INFO, WARN, ERROR, NONE]

Default value

WARN

Table 47. causal_clustering.minimum_core_cluster_size_at_formation

Description

Minimum number of Core machines initially required to form a cluster. The cluster will form when at least this many Core members have discovered each other.

Valid values

causal_clustering.minimum_core_cluster_size_at_formation, an integer which is minimum 2

Default value

3

Table 48. causal_clustering.minimum_core_cluster_size_at_runtime

Description

The minimum size of the dynamically adjusted voting set (which only core members may be a part of). Adjustments to the voting set happen automatically as the availability of core members changes, due to explicit operations such as starting or stopping a member, or unintended issues such as network partitions. Note that this dynamic scaling of the voting set is generally desirable as under some circumstances it can increase the number of instance failures which may be tolerated. A majority of the voting set must be available before voting in or out members.

Valid values

causal_clustering.minimum_core_cluster_size_at_runtime, an integer which is minimum 2 and depends on dbms.mode. If dbms.mode is CORE then it Must be set less than or equal to value of 'causal_clustering.minimum_core_cluster_size_at_formation' otherwise it is unconstrained.

Default value

3

Table 49. causal_clustering.multi_dc_license

Description

Enable multi-data center features. Requires appropriate licensing.

Valid values

causal_clustering.multi_dc_license, a boolean

Default value

false

Table 50. causal_clustering.protocol_implementations.catchup

Description

Catchup protocol implementation versions that this instance will allow in negotiation as a comma-separated list. Order is not relevant: the greatest value will be preferred. An empty list will allow all supported versions. Example value: "1.1, 1.2, 2.1, 2.2"

Valid values

causal_clustering.protocol_implementations.catchup, a ',' separated list with elements of type 'an application protocol version'.

Default value

Table 51. causal_clustering.protocol_implementations.compression

Description

Network compression algorithms that this instance will allow in negotiation as a comma-separated list. Listed in descending order of preference for incoming connections. An empty list implies no compression. For outgoing connections this merely specifies the allowed set of algorithms and the preference of the remote peer will be used for making the decision. Allowable values: [Gzip, Snappy, Snappy_validating, LZ4, LZ4_high_compression, LZ_validating, LZ4_high_compression_validating]

Valid values

causal_clustering.protocol_implementations.compression, a ',' separated list with elements of type 'a string'.

Default value

Table 52. causal_clustering.protocol_implementations.raft

Description

Raft protocol implementation versions that this instance will allow in negotiation as a comma-separated list. Order is not relevant: the greatest value will be preferred. An empty list will allow all supported versions. Example value: "1.0, 1.3, 2.0, 2.1"

Valid values

causal_clustering.protocol_implementations.raft, a ',' separated list with elements of type 'an application protocol version'.

Default value

Table 53. causal_clustering.pull_interval

Description

Interval of pulling updates from cores.

Valid values

causal_clustering.pull_interval, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

1s

Table 54. causal_clustering.raft_advertised_address

Description

Advertised hostname/IP address and port for the RAFT server.

Valid values

causal_clustering.raft_advertised_address, a socket address. If missing port or hostname it is acquired from dbms.default_advertised_address

Default value

:7000

Table 55. causal_clustering.raft_handler_parallelism

Description

Limits amount of global threads shared by raft groups for handling bathing of messages and timeout events.

Valid values

causal_clustering.raft_handler_parallelism, an integer which is minimum 1

Default value

8

Table 56. causal_clustering.raft_in_queue_max_batch_bytes

Description

Largest batch processed by RAFT in bytes.

Valid values

causal_clustering.raft_in_queue_max_batch_bytes, a byte size (valid multipliers are B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB)

Default value

8.00MiB

Table 57. causal_clustering.raft_in_queue_max_bytes

Description

Maximum number of bytes in the RAFT in-queue.

Valid values

causal_clustering.raft_in_queue_max_bytes, a byte size (valid multipliers are B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB)

Default value

2.00GiB

Table 58. causal_clustering.raft_listen_address

Description

Network interface and port for the RAFT server to listen on.

Valid values

causal_clustering.raft_listen_address, a socket address. If missing port or hostname it is acquired from dbms.default_listen_address

Default value

:7000

Table 59. causal_clustering.raft_log_implementation

Description

RAFT log implementation.

Valid values

causal_clustering.raft_log_implementation, a string

Default value

SEGMENTED

Table 60. causal_clustering.raft_log_prune_strategy

Description

RAFT log pruning strategy.

Valid values

causal_clustering.raft_log_prune_strategy, a string

Default value

1g size

Table 61. causal_clustering.raft_log_pruning_frequency

Description

RAFT log pruning frequency.

Valid values

causal_clustering.raft_log_pruning_frequency, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

10m

Table 62. causal_clustering.raft_log_reader_pool_size

Description

RAFT log reader pool size.

Valid values

causal_clustering.raft_log_reader_pool_size, an integer

Default value

8

Table 63. causal_clustering.raft_log_rotation_size

Description

RAFT log rotation size.

Valid values

causal_clustering.raft_log_rotation_size, a byte size (valid multipliers are B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB) which is minimum 1.00KiB

Default value

250.00MiB

Table 64. causal_clustering.raft_membership_state_size

Description

The maximum file size before the membership state file is rotated (in unit of entries)

Valid values

causal_clustering.raft_membership_state_size, an integer

Default value

1000

Table 65. causal_clustering.raft_term_state_size

Description

The maximum file size before the term state file is rotated (in unit of entries)

Valid values

causal_clustering.raft_term_state_size, an integer

Default value

1000

Table 66. causal_clustering.raft_vote_state_size

Description

The maximum file size before the vote state file is rotated (in unit of entries)

Valid values

causal_clustering.raft_vote_state_size, an integer

Default value

1000

Table 67. causal_clustering.refuse_to_be_leader

Description

Valid values

causal_clustering.refuse_to_be_leader, a boolean

Default value

false

Deprecated

The causal_clustering.refuse_to_be_leader configuration setting has been deprecated.

Table 68. causal_clustering.replicated_lease_state_size

Description

The maximum file size before the replicated lease state file is rotated (in unit of entries)

Valid values

causal_clustering.replicated_lease_state_size, an integer

Default value

1000

Table 69. causal_clustering.replication_leader_await_timeout

Description

The duration for which the replicator will await a new leader.

Valid values

causal_clustering.replication_leader_await_timeout, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

10s

Table 70. causal_clustering.replication_retry_timeout_base

Description

The initial timeout until replication is retried. The timeout will increase exponentially.

Valid values

causal_clustering.replication_retry_timeout_base, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

10s

Table 71. causal_clustering.replication_retry_timeout_limit

Description

The upper limit for the exponentially incremented retry timeout.

Valid values

causal_clustering.replication_retry_timeout_limit, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

1m

Table 72. causal_clustering.server_groups

Description

A list of group names for the server used when configuring load balancing and replication policies.

Valid values

causal_clustering.server_groups, a ',' separated list with elements of type 'a string identifying a Server Group'.

Dynamic

true

Default value

Table 73. causal_clustering.state_machine_apply_max_batch_size

Description

The maximum number of operations to be batched during applications of operations in the state machines.

Valid values

causal_clustering.state_machine_apply_max_batch_size, an integer

Default value

16

Table 74. causal_clustering.state_machine_flush_window_size

Description

The number of operations to be processed before the state machines flush to disk.

Valid values

causal_clustering.state_machine_flush_window_size, an integer

Default value

4096

Table 75. causal_clustering.status_throughput_window

Description

Sampling window for throughput estimate reported in the status endpoint.

Valid values

causal_clustering.status_throughput_window, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's') which is in the range 1s to 5m

Default value

5s

Table 76. causal_clustering.store_copy_chunk_size

Description

Store copy chunk size.

Valid values

causal_clustering.store_copy_chunk_size, an integer which is in the range 4096 to 1048576

Default value

32768

Table 77. causal_clustering.store_copy_max_retry_time_per_request

Description

Maximum retry time per request during store copy. Regular store files and indexes are downloaded in separate requests during store copy. This configures the maximum time failed requests are allowed to resend.

Valid values

causal_clustering.store_copy_max_retry_time_per_request, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

20m

Table 78. causal_clustering.store_copy_parallelism

Description

Limits amount of global threads for store copy.

Valid values

causal_clustering.store_copy_parallelism, an integer which is minimum 1

Default value

8

Table 79. causal_clustering.transaction_advertised_address

Description

Advertised hostname/IP address and port for the transaction shipping server.

Valid values

causal_clustering.transaction_advertised_address, a socket address. If missing port or hostname it is acquired from dbms.default_advertised_address

Default value

:6000

Table 80. causal_clustering.transaction_listen_address

Description

Network interface and port for the transaction shipping server to listen on. Please note that it is also possible to run the backup client against this port so always limit access to it via the firewall and configure an ssl policy.

Valid values

causal_clustering.transaction_listen_address, a socket address. If missing port or hostname it is acquired from dbms.default_listen_address

Default value

:6000

Table 81. causal_clustering.unknown_address_logging_throttle

Description

Throttle limit for logging unknown cluster member address.

Valid values

causal_clustering.unknown_address_logging_throttle, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

10s

Table 82. causal_clustering.upstream_selection_strategy

Description

An ordered list in descending preference of the strategy which read replicas use to choose the upstream server from which to pull transactional updates.

Valid values

causal_clustering.upstream_selection_strategy, a ',' separated list with elements of type 'a string'.

Default value

default

Table 83. causal_clustering.user_defined_upstream_strategy

Description

Configuration of a user-defined upstream selection strategy. The user-defined strategy is used if the list of strategies (causal_clustering.upstream_selection_strategy) includes the value user_defined.

Valid values

causal_clustering.user_defined_upstream_strategy, a string

Default value

Table 84. cypher.default_language_version

Description

Set this to specify the default parser (language version).

Valid values

cypher.default_language_version, one of [default, 3.5, 4.2, 4.3]

Default value

default

Table 85. cypher.forbid_exhaustive_shortestpath

Description

This setting is associated with performance optimization. Set this to true in situations where it is preferable to have any queries using the 'shortestPath' function terminate as soon as possible with no answer, rather than potentially running for a long time attempting to find an answer (even if there is no path to be found). For most queries, the 'shortestPath' algorithm will return the correct answer very quickly. However there are some cases where it is possible that the fast bidirectional breadth-first search algorithm will find no results even if they exist. This can happen when the predicates in the WHERE clause applied to 'shortestPath' cannot be applied to each step of the traversal, and can only be applied to the entire path. When the query planner detects these special cases, it will plan to perform an exhaustive depth-first search if the fast algorithm finds no paths. However, the exhaustive search may be orders of magnitude slower than the fast algorithm. If it is critical that queries terminate as soon as possible, it is recommended that this option be set to true, which means that Neo4j will never consider using the exhaustive search for shortestPath queries. However, please note that if no paths are found, an error will be thrown at run time, which will need to be handled by the application.

Valid values

cypher.forbid_exhaustive_shortestpath, a boolean

Default value

false

Table 86. cypher.forbid_shortestpath_common_nodes

Description

This setting is associated with performance optimization. The shortest path algorithm does not work when the start and end nodes are the same. With this setting set to false no path will be returned when that happens. The default value of true will instead throw an exception. This can happen if you perform a shortestPath search after a cartesian product that might have the same start and end nodes for some of the rows passed to shortestPath. If it is preferable to not experience this exception, and acceptable for results to be missing for those rows, then set this to false. If you cannot accept missing results, and really want the shortestPath between two common nodes, then re-write the query using a standard Cypher variable length pattern expression followed by ordering by path length and limiting to one result.

Valid values

cypher.forbid_shortestpath_common_nodes, a boolean

Default value

true

Table 87. cypher.hints_error

Description

Set this to specify the behavior when Cypher planner or runtime hints cannot be fulfilled. If true, then non-conformance will result in an error, otherwise only a warning is generated.

Valid values

cypher.hints_error, a boolean

Default value

false

Table 88. cypher.lenient_create_relationship

Description

Set this to change the behavior for Cypher create relationship when the start or end node is missing. By default this fails the query and stops execution, but by setting this flag the create operation is simply not performed and execution continues.

Valid values

cypher.lenient_create_relationship, a boolean

Default value

false

Table 89. cypher.min_replan_interval

Description

The minimum time between possible cypher query replanning events. After this time, the graph statistics will be evaluated, and if they have changed by more than the value set by cypher.statistics_divergence_threshold, the query will be replanned. If the statistics have not changed sufficiently, the same interval will need to pass before the statistics will be evaluated again. Each time they are evaluated, the divergence threshold will be reduced slightly until it reaches 10% after 7h, so that even moderately changing databases will see query replanning after a sufficiently long time interval.

Valid values

cypher.min_replan_interval, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

10s

Table 90. cypher.planner

Description

Set this to specify the default planner for the default language version.

Valid values

cypher.planner, one of [DEFAULT, COST]

Default value

DEFAULT

Table 91. cypher.statistics_divergence_threshold

Description

The threshold for statistics above which a plan is considered stale.

If any of the underlying statistics used to create the plan have changed more than this value, the plan will be considered stale and will be replanned. Change is calculated as abs(a-b)/max(a,b).

This means that a value of 0.75 requires the database to quadruple in size before query replanning. A value of 0 means that the query will be replanned as soon as there is any change in statistics and the replan interval has elapsed.

This interval is defined by cypher.min_replan_interval and defaults to 10s. After this interval, the divergence threshold will slowly start to decline, reaching 10% after about 7h. This will ensure that long running databases will still get query replanning on even modest changes, while not replanning frequently unless the changes are very large.

Valid values

cypher.statistics_divergence_threshold, a double which is in the range 0.0 to 1.0

Default value

0.75

Table 92. db.temporal.timezone

Description

Database timezone for temporal functions. All Time and DateTime values that are created without an explicit timezone will use this configured default timezone.

Valid values

db.temporal.timezone, a string describing a timezone, either described by offset (e.g. '+02:00') or by name (e.g. 'Europe/Stockholm')

Default value

Z

Table 93. dbms.allow_single_automatic_upgrade

Description

Whether to allow a system graph upgrade to happen automatically in single instance mode (dbms.mode=SINGLE). Default is true. In clustering environments no automatic upgrade will happen (dbms.mode=CORE or dbms.mode=READ_REPLICA). If set to false, or when in a clustering environment, it is necessary to call the procedure dbms.upgrade() to complete the upgrade.

Valid values

dbms.allow_single_automatic_upgrade, a boolean

Dynamic

true

Default value

true

Table 94. dbms.allow_upgrade

Description

Whether to allow a store upgrade in case the current version of the database starts against an older version of the store.

Valid values

dbms.allow_upgrade, a boolean

Dynamic

true

Default value

false

Table 95. dbms.backup.enabled

Description

Enable support for running online backups.

Valid values

dbms.backup.enabled, a boolean

Default value

true

Table 96. dbms.backup.incremental.strategy

Description

Strategy for incremental backup. START_TIME means that this server will send transactions until the time of when the backup started has been reached. UNBOUNDED will keep sending until all committed transactions have been sent, even if they where committed after the backup job started.

Valid values

dbms.backup.incremental.strategy, one of [UNBOUNDED, START_TIME]

Dynamic

true

Default value

UNBOUNDED

Table 97. dbms.backup.listen_address

Description

Network interface and port for the backup server to listen on.

Valid values

dbms.backup.listen_address, a socket address

Default value

127.0.0.1:6362

Table 98. dbms.checkpoint

Description

Configures the general policy for when check-points should occur. The default policy is the 'periodic' check-point policy, as specified by the 'dbms.checkpoint.interval.tx' and 'dbms.checkpoint.interval.time' settings. The Neo4j Enterprise Edition provides two alternative policies: The first is the 'continuous' check-point policy, which will ignore those settings and run the check-point process all the time. The second is the 'volumetric' check-point policy, which makes a best-effort at check-pointing often enough so that the database doesn’t get too far behind on deleting old transaction logs in accordance with the 'dbms.tx_log.rotation.retention_policy' setting.

Valid values

dbms.checkpoint, one of [PERIODIC, CONTINUOUS, VOLUMETRIC]

Default value

PERIODIC

Table 99. dbms.checkpoint.interval.time

Description

Configures the time interval between check-points. The database will not check-point more often than this (unless check pointing is triggered by a different event), but might check-point less often than this interval, if performing a check-point takes longer time than the configured interval. A check-point is a point in the transaction logs, from which recovery would start from. Longer check-point intervals typically means that recovery will take longer to complete in case of a crash. On the other hand, a longer check-point interval can also reduce the I/O load that the database places on the system, as each check-point implies a flushing and forcing of all the store files.

Valid values

dbms.checkpoint.interval.time, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

15m

Table 100. dbms.checkpoint.interval.tx

Description

Configures the transaction interval between check-points. The database will not check-point more often than this (unless check pointing is triggered by a different event), but might check-point less often than this interval, if performing a check-point takes longer time than the configured interval. A check-point is a point in the transaction logs, from which recovery would start from. Longer check-point intervals typically means that recovery will take longer to complete in case of a crash. On the other hand, a longer check-point interval can also reduce the I/O load that the database places on the system, as each check-point implies a flushing and forcing of all the store files. The default is '100000' for a check-point every 100000 transactions.

Valid values

dbms.checkpoint.interval.tx, an integer which is minimum 1

Default value

100000

Table 101. dbms.checkpoint.iops.limit

Description

Limit the number of IOs the background checkpoint process will consume per second. This setting is advisory, is ignored in Neo4j Community Edition, and is followed to best effort in Enterprise Edition. An IO is in this case a 8 KiB (mostly sequential) write. Limiting the write IO in this way will leave more bandwidth in the IO subsystem to service random-read IOs, which is important for the response time of queries when the database cannot fit entirely in memory. The only drawback of this setting is that longer checkpoint times may lead to slightly longer recovery times in case of a database or system crash. A lower number means lower IO pressure, and consequently longer checkpoint times. Set this to -1 to disable the IOPS limit and remove the limitation entirely; this will let the checkpointer flush data as fast as the hardware will go. Removing the setting, or commenting it out, will set the default value of 600.

Valid values

dbms.checkpoint.iops.limit, an integer

Dynamic

true

Default value

600

Table 102. dbms.clustering.enable

Description

Enable discovery service and a catchup server to be started on an Enterprise Standalone Instance 'dbms.mode=SINGLE', and with that allow for Read Replicas to connect and pull transaction from it. When 'dbms.mode' is clustered (CORE, READ_REPLICA) this setting is not recognized.

Valid values

dbms.clustering.enable, a boolean

Default value

false

Deprecated

The dbms.clustering.enable configuration setting has been deprecated.

Table 103. dbms.config.strict_validation

Description

A strict configuration validation will prevent the database from starting up if unknown configuration options are specified in the neo4j settings namespace (such as dbms., cypher., etc).

Valid values

dbms.config.strict_validation, a boolean

Default value

false

Table 104. dbms.connector.bolt.advertised_address

Description

Advertised address for this connector.

Valid values

dbms.connector.bolt.advertised_address, a socket address. If missing port or hostname it is acquired from dbms.default_advertised_address

Default value

:7687

Table 105. dbms.connector.bolt.enabled

Description

Enable the bolt connector.

Valid values

dbms.connector.bolt.enabled, a boolean

Default value

true

Table 106. dbms.connector.bolt.listen_address

Description

Address the connector should bind to.

Valid values

dbms.connector.bolt.listen_address, a socket address. If missing port or hostname it is acquired from dbms.default_listen_address

Default value

:7687

Table 107. dbms.connector.bolt.ocsp_stapling_enabled

Description

Enable server OCSP stapling for bolt and http connectors.

Valid values

dbms.connector.bolt.ocsp_stapling_enabled, a boolean

Default value

false

Table 108. dbms.connector.bolt.thread_pool_keep_alive

Description

The maximum time an idle thread in the thread pool bound to this connector will wait for new tasks.

Valid values

dbms.connector.bolt.thread_pool_keep_alive, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

5m

Table 109. dbms.connector.bolt.thread_pool_max_size

Description

The maximum number of threads allowed in the thread pool bound to this connector.

Valid values

dbms.connector.bolt.thread_pool_max_size, an integer

Default value

400

Table 110. dbms.connector.bolt.thread_pool_min_size

Description

The number of threads to keep in the thread pool bound to this connector, even if they are idle.

Valid values

dbms.connector.bolt.thread_pool_min_size, an integer

Default value

5

Table 111. dbms.connector.bolt.tls_level

Description

Encryption level to require this connector to use.

Valid values

dbms.connector.bolt.tls_level, one of [REQUIRED, OPTIONAL, DISABLED]

Default value

DISABLED

Table 112. dbms.connector.bolt.unsupported_thread_pool_shutdown_wait_time

Description

The maximum time to wait for the thread pool to finish processing its pending jobs and shutdown.

Valid values

dbms.connector.bolt.unsupported_thread_pool_shutdown_wait_time, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

5s

Table 113. dbms.connector.http.advertised_address

Description

Advertised address for this connector.

Valid values

dbms.connector.http.advertised_address, a socket address. If missing port or hostname it is acquired from dbms.default_advertised_address

Default value

:7474

Table 114. dbms.connector.http.enabled

Description

Enable the http connector.

Valid values

dbms.connector.http.enabled, a boolean

Default value

true

Table 115. dbms.connector.http.listen_address

Description

Address the connector should bind to.

Valid values

dbms.connector.http.listen_address, a socket address. If missing port or hostname it is acquired from dbms.default_listen_address

Default value

:7474

Table 116. dbms.connector.https.advertised_address

Description

Advertised address for this connector.

Valid values

dbms.connector.https.advertised_address, a socket address. If missing port or hostname it is acquired from dbms.default_advertised_address

Default value

:7473

Table 117. dbms.connector.https.enabled

Description

Enable the https connector.

Valid values

dbms.connector.https.enabled, a boolean

Default value

false

Table 118. dbms.connector.https.listen_address

Description

Address the connector should bind to.

Valid values

dbms.connector.https.listen_address, a socket address. If missing port or hostname it is acquired from dbms.default_listen_address

Default value

:7473

Table 119. dbms.databases.default_to_read_only

Description

Whether or not any database on this instance are read_only by default. If false, individual databases may be marked as read_only using dbms.database.read_only. If true, individual databases may be marked as writable using dbms.databases.writable.

Valid values

dbms.databases.default_to_read_only, a boolean

Dynamic

true

Default value

false

Table 120. dbms.databases.read_only

Description

List of databases for which to prevent write queries. Databases not included in this list maybe read_only anyway depending upon the value of dbms.databases.default_to_read_only.

Valid values

dbms.databases.read_only, a ',' separated set with elements of type 'A valid database name. Containing only alphabetic characters, numbers, dots and dashes, with a length between 3 and 63 characters. It should be starting with an alphabetic character but not with the name 'system'.'. which Value 'system' can’t be included in read only databases collection!

Dynamic

true

Default value

Table 121. dbms.databases.writable

Description

List of databases for which to allow write queries. Databases not included in this list will allow write queries anyway, unless dbms.databases.default_to_read_only is set to true.

Valid values

dbms.databases.writable, a ',' separated set with elements of type 'A valid database name. Containing only alphabetic characters, numbers, dots and dashes, with a length between 3 and 63 characters. It should be starting with an alphabetic character but not with the name 'system'.'.

Dynamic

true

Default value

Table 122. dbms.db.timezone

Description

Database timezone. Among other things, this setting influences which timezone the logs and monitoring procedures use.

Valid values

dbms.db.timezone, one of [UTC, SYSTEM]

Default value

UTC

Table 123. dbms.default_advertised_address

Description

Default hostname or IP address the server uses to advertise itself.

Valid values

dbms.default_advertised_address, a socket address which has no specified port

Default value

localhost

Table 124. dbms.default_database

Description

Name of the default database.

Valid values

dbms.default_database, A valid database name. Containing only alphabetic characters, numbers, dots and dashes, with a length between 3 and 63 characters. It should be starting with an alphabetic character but not with the name 'system'.

Default value

neo4j

Table 125. dbms.default_listen_address

Description

Default network interface to listen for incoming connections. To listen for connections on all interfaces, use "0.0.0.0".

Valid values

dbms.default_listen_address, a socket address which has no specified port

Default value

localhost

Table 126. dbms.directories.cluster_state

Description

Directory to hold cluster state including Raft log.

Valid values

dbms.directories.cluster_state, a path. If relative it is resolved from dbms.directories.data

Default value

cluster-state

Table 127. dbms.directories.data

Description

Path of the data directory. You must not configure more than one Neo4j installation to use the same data directory.

Valid values

dbms.directories.data, a path. If relative it is resolved from dbms.directories.neo4j_home

Default value

data

Table 128. dbms.directories.dumps.root

Description

Root location where Neo4j will store database dumps optionally produced when dropping said databases.

Valid values

dbms.directories.dumps.root, a path. If relative it is resolved from dbms.directories.data

Default value

dumps

Table 129. dbms.directories.import

Description

Sets the root directory for file URLs used with the Cypher LOAD CSV clause. This should be set to a directory relative to the Neo4j installation path, restricting access to only those files within that directory and its subdirectories. For example the value "import" will only enable access to files within the 'import' folder. Removing this setting will disable the security feature, allowing all files in the local system to be imported. Setting this to an empty field will allow access to all files within the Neo4j installation folder.

Valid values

dbms.directories.import, a path. If relative it is resolved from dbms.directories.neo4j_home

Table 130. dbms.directories.lib

Description

Path of the lib directory.

Valid values

dbms.directories.lib, a path. If relative it is resolved from dbms.directories.neo4j_home

Default value

lib

Table 131. dbms.directories.licenses

Description

Path of the licenses directory.

Valid values

dbms.directories.licenses, a path. If relative it is resolved from dbms.directories.neo4j_home

Default value

licenses

Table 132. dbms.directories.logs

Description

Path of the logs directory.

Valid values

dbms.directories.logs, a path. If relative it is resolved from dbms.directories.neo4j_home

Default value

logs

Table 133. dbms.directories.metrics

Description

The target location of the CSV files: a path to a directory wherein a CSV file per reported field will be written.

Valid values

dbms.directories.metrics, a path. If relative it is resolved from dbms.directories.neo4j_home

Default value

metrics

Table 134. dbms.directories.neo4j_home

Description

Root relative to which directory settings are resolved.

Valid values

dbms.directories.neo4j_home, a path which is absolute

Default value

Defaults to current working directory

Table 135. dbms.directories.plugins

Description

Location of the database plugin directory. Compiled Java JAR files that contain database procedures will be loaded if they are placed in this directory.

Valid values

dbms.directories.plugins, a path. If relative it is resolved from dbms.directories.neo4j_home

Default value

plugins

Table 136. dbms.directories.run

Description

Path of the run directory. This directory holds Neo4j’s runtime state, such as a pidfile when it is running in the background. The pidfile is created when starting neo4j and removed when stopping it. It may be placed on an in-memory filesystem such as tmpfs.

Valid values

dbms.directories.run, a path. If relative it is resolved from dbms.directories.neo4j_home

Default value

run

Table 137. dbms.directories.script.root

Description

Root location where Neo4j will store scripts for configured databases.

Valid values

dbms.directories.script.root, a path. If relative it is resolved from dbms.directories.data

Default value

scripts

Table 138. dbms.directories.transaction.logs.root

Description

Root location where Neo4j will store transaction logs for configured databases.

Valid values

dbms.directories.transaction.logs.root, a path. If relative it is resolved from dbms.directories.data

Default value

transactions

Table 139. dbms.dynamic.setting.allowlist

Description

A list of setting name patterns (comma separated) that are allowed to be dynamically changed. The list may contain both full setting names, and partial names with the wildcard '*'. If this setting is left empty all dynamic settings updates will be blocked.

Valid values

dbms.dynamic.setting.allowlist, a ',' separated list with elements of type 'a string'.

Default value

*

Table 140. dbms.dynamic.setting.whitelist

Description

A list of setting name patterns (comma separated) that are allowed to be dynamically changed. The list may contain both full setting names, and partial names with the wildcard '*'. If this setting is left empty all dynamic settings updates will be blocked. Deprecated, use dbms.dynamic.setting.allowlist

Valid values

dbms.dynamic.setting.whitelist, a ',' separated list with elements of type 'a string'.

Default value

*

Deprecated

The dbms.dynamic.setting.whitelist configuration setting has been deprecated.

Table 141. dbms.filewatcher.enabled

Description

Allows the enabling or disabling of the file watcher service. This is an auxiliary service but should be left enabled in almost all cases.

Valid values

dbms.filewatcher.enabled, a boolean

Default value

true

Table 142. dbms.http_enabled_modules

Description

Defines the set of modules loaded into the Neo4j web server. Options include TRANSACTIONAL_ENDPOINTS, BROWSER, UNMANAGED_EXTENSIONS and ENTERPRISE_MANAGEMENT_ENDPOINTS (if applicable).

Valid values

dbms.http_enabled_modules, a ',' separated set with elements of type 'one of [TRANSACTIONAL_ENDPOINTS, UNMANAGED_EXTENSIONS, BROWSER, ENTERPRISE_MANAGEMENT_ENDPOINTS]'.

Default value

TRANSACTIONAL_ENDPOINTS,UNMANAGED_EXTENSIONS,BROWSER,ENTERPRISE_MANAGEMENT_ENDPOINTS

Table 143. dbms.import.csv.buffer_size

Description

The size of the internal buffer in bytes used by LOAD CSV. If the csv file contains huge fields this value may have to be increased.

Valid values

dbms.import.csv.buffer_size, a long which is minimum 1

Default value

2097152

Table 144. dbms.import.csv.legacy_quote_escaping

Description

Selects whether to conform to the standard https://tools.ietf.org/html/rfc4180 for interpreting escaped quotation characters in CSV files loaded using LOAD CSV. Setting this to false will use the standard, interpreting repeated quotes '""' as a single in-lined quote, while true will use the legacy convention originally supported in Neo4j 3.0 and 3.1, allowing a backslash to include quotes in-lined in fields.

Valid values

dbms.import.csv.legacy_quote_escaping, a boolean

Default value

true

Table 145. dbms.index.default_schema_provider

Description

Index provider to use for newly created schema indexes. An index provider may store different value types in separate physical indexes. native-btree-1.0: All value types and arrays of all value types, even composite keys, are stored in one native index. lucene+native-3.0: Like native-btree-1.0 but single property strings are stored in Lucene. A native index has faster updates, less heap and CPU usage compared to a Lucene index. A native index has some limitations around key size and slower execution of CONTAINS and ENDS WITH string index queries, compared to a Lucene index. Deprecated: Which index provider to use will be a fully internal concern.

Valid values

dbms.index.default_schema_provider, a string

Default value

native-btree-1.0

Deprecated

The dbms.index.default_schema_provider configuration setting has been deprecated.

Table 146. dbms.index.fulltext.default_analyzer

Description

The name of the analyzer that the fulltext indexes should use by default.

Valid values

dbms.index.fulltext.default_analyzer, a string

Default value

standard-no-stop-words

Table 147. dbms.index.fulltext.eventually_consistent

Description

Whether or not fulltext indexes should be eventually consistent by default or not.

Valid values

dbms.index.fulltext.eventually_consistent, a boolean

Default value

false

Table 148. dbms.index.fulltext.eventually_consistent_index_update_queue_max_length

Description

The eventually_consistent mode of the fulltext indexes works by queueing up index updates to be applied later in a background thread. This newBuilder sets an upper bound on how many index updates are allowed to be in this queue at any one point in time. When it is reached, the commit process will slow down and wait for the index update applier thread to make some more room in the queue.

Valid values

dbms.index.fulltext.eventually_consistent_index_update_queue_max_length, an integer which is in the range 1 to 50000000

Default value

10000

Table 149. dbms.index_sampling.background_enabled

Description

Enable or disable background index sampling.

Valid values

dbms.index_sampling.background_enabled, a boolean

Default value

true

Table 150. dbms.index_sampling.sample_size_limit

Description

Index sampling chunk size limit.

Valid values

dbms.index_sampling.sample_size_limit, an integer which is in the range 1048576 to 2147483647

Default value

8388608

Table 151. dbms.index_sampling.update_percentage

Description

Percentage of index updates of total index size required before sampling of a given index is triggered.

Valid values

dbms.index_sampling.update_percentage, an integer which is minimum 0

Default value

5

Table 152. dbms.index_searcher_cache_size

Description

The maximum number of open Lucene index searchers.

Valid values

dbms.index_searcher_cache_size, an integer which is minimum 1

Default value

2147483647

Deprecated

The dbms.index_searcher_cache_size configuration setting has been deprecated.

Table 153. dbms.jvm.additional

Description

Additional JVM arguments. Argument order can be significant. To use a Java commercial feature, the argument to unlock commercial features must precede the argument to enable the specific feature in the config value string. For example, to use Flight Recorder, -XX:+UnlockCommercialFeatures must come before -XX:+FlightRecorder.

Valid values

dbms.jvm.additional, one or more jvm arguments

Table 154. dbms.lock.acquisition.timeout

Description

The maximum time interval within which lock should be acquired. Zero (default) means timeout is disabled.

Valid values

dbms.lock.acquisition.timeout, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Dynamic

true

Default value

0s

Table 155. dbms.logs.debug.format

Description

Log format to use for debug log.

Valid values

dbms.logs.debug.format, one of [PLAIN, JSON]. If unset the value is inherited from dbms.logs.default_format

Table 156. dbms.logs.debug.level

Description

Debug log level threshold.

Valid values

dbms.logs.debug.level, one of [DEBUG, INFO, WARN, ERROR, NONE]

Dynamic

true

Default value

INFO

Table 157. dbms.logs.debug.path

Description

Path to the debug log file.

Valid values

dbms.logs.debug.path, a path. If relative it is resolved from dbms.directories.logs

Default value

debug.log

Table 158. dbms.logs.debug.rotation.delay

Description

Minimum time interval after last rotation of the debug log before it may be rotated again.

Valid values

dbms.logs.debug.rotation.delay, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

5m

Deprecated

The dbms.logs.debug.rotation.delay configuration setting has been deprecated.

Table 159. dbms.logs.debug.rotation.keep_number

Description

Maximum number of history files for the debug log.

Valid values

dbms.logs.debug.rotation.keep_number, an integer which is minimum 1

Default value

7

Table 160. dbms.logs.debug.rotation.size

Description

Threshold for rotation of the debug log.

Valid values

dbms.logs.debug.rotation.size, a byte size (valid multipliers are B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB) which is in the range 0B to 8388608.00TiB

Default value

20.00MiB

Table 161. dbms.logs.default_format

Description

Default log format. Will apply to all logs unless overridden.

Valid values

dbms.logs.default_format, one of [PLAIN, JSON]

Default value

PLAIN

Table 162. dbms.logs.gc.enabled

Description

Enable GC Logging.

Valid values

dbms.logs.gc.enabled, a boolean

Default value

false

Table 163. dbms.logs.gc.options

Description

GC Logging Options.

Valid values

dbms.logs.gc.options, a string

Default value

-Xlog:gc*,safepoint,age*=trace

Table 164. dbms.logs.gc.rotation.keep_number

Description

Number of GC logs to keep.

Valid values

dbms.logs.gc.rotation.keep_number, an integer

Default value

5

Table 165. dbms.logs.gc.rotation.size

Description

Size of each GC log that is kept.

Valid values

dbms.logs.gc.rotation.size, a byte size (valid multipliers are B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB)

Default value

20.00MiB

Table 166. dbms.logs.http.enabled

Description

Enable HTTP request logging.

Valid values

dbms.logs.http.enabled, a boolean

Default value

false

Table 167. dbms.logs.http.path

Description

Path to HTTP request log.

Valid values

dbms.logs.http.path, a path. If relative it is resolved from dbms.directories.logs

Default value

http.log

Table 168. dbms.logs.http.rotation.keep_number

Description

Number of HTTP logs to keep.

Valid values

dbms.logs.http.rotation.keep_number, an integer

Default value

5

Table 169. dbms.logs.http.rotation.size

Description

Size of each HTTP log that is kept.

Valid values

dbms.logs.http.rotation.size, a byte size (valid multipliers are B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB) which is in the range 0B to 8388608.00TiB

Default value

20.00MiB

Table 170. dbms.logs.query.allocation_logging_enabled

Description

Log allocated bytes for the executed queries being logged. The logged number is cumulative over the duration of the query, i.e. for memory intense or long-running queries the value may be larger than the current memory allocation. Requires dbms.track_query_allocation=true

Valid values

dbms.logs.query.allocation_logging_enabled, a boolean

Dynamic

true

Default value

true

Table 171. dbms.logs.query.early_raw_logging_enabled

Description

Log query text and parameters without obfuscating passwords. This allows queries to be logged earlier before parsing starts.

Valid values

dbms.logs.query.early_raw_logging_enabled, a boolean

Dynamic

true

Default value

false

Table 172. dbms.logs.query.enabled

Description

Log executed queries. Valid values are OFF, INFO, or VERBOSE.

OFF

no logging.

INFO

log queries at the end of execution, that take longer than the configured threshold, dbms.logs.query.threshold.

VERBOSE

log queries at the start and end of execution, regardless of dbms.logs.query.threshold.

Log entries are written to the query log (dbms.logs.query.path).

This feature is available in the Neo4j Enterprise Edition.

Valid values

dbms.logs.query.enabled, one of [OFF, INFO, VERBOSE]

Dynamic

true

Default value

VERBOSE

Table 173. dbms.logs.query.format

Description

Log format to use for the query log.

Valid values

dbms.logs.query.format, one of [PLAIN, JSON]. If unset the value is inherited from dbms.logs.default_format

Table 174. dbms.logs.query.max_parameter_length

Description

Sets a maximum character length use for each parameter in the log. This only takes effect if dbms.logs.query.parameter_logging_enabled = true.

Valid values

dbms.logs.query.max_parameter_length, an integer

Dynamic

true

Default value

2147483647

Table 175. dbms.logs.query.obfuscate_literals

Description

Obfuscates all literals of the query before writing to the log. Note that node labels, relationship types and map property keys are still shown. Changing the setting will not affect queries that are cached. So, if you want the switch to have immediate effect, you must also call CALL db.clearQueryCaches().

Valid values

dbms.logs.query.obfuscate_literals, a boolean

Dynamic

true

Default value

false

Table 176. dbms.logs.query.page_logging_enabled

Description

Log page hits and page faults for the executed queries being logged.

Valid values

dbms.logs.query.page_logging_enabled, a boolean

Dynamic

true

Default value

false

Table 177. dbms.logs.query.parameter_full_entities

Description

Log complete parameter entities including id, labels or relationship type, and properties. If false, only the entity id will be logged. This only takes effect if dbms.logs.query.parameter_logging_enabled = true.

Valid values

dbms.logs.query.parameter_full_entities, a boolean

Dynamic

true

Default value

false

Table 178. dbms.logs.query.parameter_logging_enabled

Description

Log parameters for the executed queries being logged.

Valid values

dbms.logs.query.parameter_logging_enabled, a boolean

Dynamic

true

Default value

true

Table 179. dbms.logs.query.path

Description

Path to the query log file.

Valid values

dbms.logs.query.path, a path. If relative it is resolved from dbms.directories.logs

Default value

query.log

Table 180. dbms.logs.query.plan_description_enabled

Description

Log query plan description table, useful for debugging purposes.

Valid values

dbms.logs.query.plan_description_enabled, a boolean

Dynamic

true

Default value

false

Table 181. dbms.logs.query.rotation.keep_number

Description

Maximum number of history files for the query log.

Valid values

dbms.logs.query.rotation.keep_number, an integer which is minimum 1

Dynamic

true

Default value

7

Table 182. dbms.logs.query.rotation.size

Description

The file size in bytes at which the query log will auto-rotate. If set to zero then no rotation will occur. Accepts a binary suffix k, m or g.

Valid values

dbms.logs.query.rotation.size, a byte size (valid multipliers are B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB) which is in the range 0B to 8388608.00TiB

Dynamic

true

Default value

20.00MiB

Table 183. dbms.logs.query.runtime_logging_enabled

Description

Logs which runtime that was used to run the query.

Valid values

dbms.logs.query.runtime_logging_enabled, a boolean

Dynamic

true

Default value

true

Table 184. dbms.logs.query.threshold

Description

If the execution of query takes more time than this threshold, the query is logged once completed - provided query logging is set to INFO. Defaults to 0 seconds, that is all queries are logged.

Valid values

dbms.logs.query.threshold, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Dynamic

true

Default value

0s

Table 185. dbms.logs.query.time_logging_enabled

Description

Log detailed time information for the executed queries being logged. Requires dbms.track_query_cpu_time=true

Valid values

dbms.logs.query.time_logging_enabled, a boolean

Dynamic

true

Default value

false

Table 186. dbms.logs.query.transaction.enabled

Description

Log the start and end of a transaction. Valid values are 'OFF', 'INFO', or 'VERBOSE'. OFF: no logging. INFO: log start and end of transactions that take longer than the configured threshold, dbms.logs.query.transaction.threshold. VERBOSE: log start and end of all transactions. Log entries are written to the query log (dbms.logs.query.path). This feature is available in the Neo4j Enterprise Edition.

Valid values

dbms.logs.query.transaction.enabled, one of [OFF, INFO, VERBOSE]

Dynamic

true

Default value

OFF

Table 187. dbms.logs.query.transaction.threshold

Description

If the transaction is open for more time than this threshold, the transaction is logged once completed - provided transaction logging (dbms.logs.query.transaction.enabled) is set to INFO. Defaults to 0 seconds (all transactions are logged).

Valid values

dbms.logs.query.transaction.threshold, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Dynamic

true

Default value

0s

Table 188. dbms.logs.query.transaction_id.enabled

Description

Log transaction ID for the executed queries.

Valid values

dbms.logs.query.transaction_id.enabled, a boolean

Dynamic

true

Default value

false

Table 189. dbms.logs.security.format

Description

Log format to use for security log.

Valid values

dbms.logs.security.format, one of [PLAIN, JSON]. If unset the value is inherited from dbms.logs.default_format

Table 190. dbms.logs.security.level

Description

Security log level threshold.

Valid values

dbms.logs.security.level, one of [DEBUG, INFO, WARN, ERROR, NONE]

Default value

INFO

Table 191. dbms.logs.security.path

Description

Path to the security log file.

Valid values

dbms.logs.security.path, a path. If relative it is resolved from dbms.directories.logs

Default value

security.log

Table 192. dbms.logs.security.rotation.delay

Description

Minimum time interval after last rotation of the security log before it may be rotated again.

Valid values

dbms.logs.security.rotation.delay, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

5m

Deprecated

The dbms.logs.security.rotation.delay configuration setting has been deprecated.

Table 193. dbms.logs.security.rotation.keep_number

Description

Maximum number of history files for the security log.

Valid values

dbms.logs.security.rotation.keep_number, an integer which is minimum 1

Default value

7

Table 194. dbms.logs.security.rotation.size

Description

Threshold for rotation of the security log.

Valid values

dbms.logs.security.rotation.size, a byte size (valid multipliers are B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB) which is in the range 0B to 8388608.00TiB

Default value

20.00MiB

Table 195. dbms.logs.user.format

Description

Log format to use for user log.

Valid values

dbms.logs.user.format, one of [PLAIN, JSON]. If unset the value is inherited from dbms.logs.default_format

Table 196. dbms.logs.user.path

Description

Path to the user log file. Note that if dbms.logs.user.stdout_enabled is enabled this setting will be ignored.

Valid values

dbms.logs.user.path, a path. If relative it is resolved from dbms.directories.logs

Default value

neo4j.log

Table 197. dbms.logs.user.rotation.delay

Description

Minimum time interval after last rotation of the user log (neo4j.log) before it may be rotated again. Note that if dbms.logs.user.stdout_enabled is enabled this setting will be ignored.

Valid values

dbms.logs.user.rotation.delay, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

5m

Deprecated

The dbms.logs.user.rotation.delay configuration setting has been deprecated.

Table 198. dbms.logs.user.rotation.keep_number

Description

Maximum number of history files for the user log (neo4j.log). Note that if dbms.logs.user.stdout_enabled is enabled this setting will be ignored.

Valid values

dbms.logs.user.rotation.keep_number, an integer which is minimum 1

Default value

7

Table 199. dbms.logs.user.rotation.size

Description

Threshold for rotation of the user log (neo4j.log). If set to 0, log rotation is disabled. Note that if dbms.logs.user.stdout_enabled is enabled this setting will be ignored.

Valid values

dbms.logs.user.rotation.size, a byte size (valid multipliers are B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB) which is in the range 0B to 8388608.00TiB

Default value

0B

Table 200. dbms.logs.user.stdout_enabled

Description

Send user logs to the process stdout. If this is disabled then logs will instead be sent to the file neo4j.log located in the logs directory.

Valid values

dbms.logs.user.stdout_enabled, a boolean

Default value

true

Table 201. dbms.max_databases

Description

The maximum number of databases.

Valid values

dbms.max_databases, a long which is minimum 2

Default value

100

Table 202. dbms.memory.heap.initial_size

Description

Initial heap size. By default it is calculated based on available system resources.

Valid values

dbms.memory.heap.initial_size, a byte size (valid multipliers are B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB)

Table 203. dbms.memory.heap.max_size

Description

Maximum heap size. By default it is calculated based on available system resources.

Valid values

dbms.memory.heap.max_size, a byte size (valid multipliers are B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB)

Table 204. dbms.memory.off_heap.block_cache_size

Description

Defines the size of the off-heap memory blocks cache. The cache will contain this number of blocks for each block size that is power of two. Thus, maximum amount of memory used by blocks cache can be calculated as 2 * dbms.memory.off_heap.max_cacheable_block_size * dbms.memory.off_heap.block_cache_size

Valid values

dbms.memory.off_heap.block_cache_size, an integer which is minimum 16

Default value

128

Table 205. dbms.memory.off_heap.max_cacheable_block_size

Description

Defines the maximum size of an off-heap memory block that can be cached to speed up allocations. The value must be a power of 2.

Valid values

dbms.memory.off_heap.max_cacheable_block_size, a byte size (valid multipliers are B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB) which is minimum 4.00KiB and is power of 2

Default value

512.00KiB

Table 206. dbms.memory.off_heap.max_size

Description

The maximum amount of off-heap memory that can be used to store transaction state data; it’s a total amount of memory shared across all active transactions. Zero means 'unlimited'. Used when dbms.tx_state.memory_allocation is set to 'OFF_HEAP'.

Valid values

dbms.memory.off_heap.max_size, a byte size (valid multipliers are B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB) which is minimum 0B

Default value

2.00GiB

Table 207. dbms.memory.pagecache.directio

Description

Use direct I/O for page cache. Setting is supported only on Linux and only for a subset of record formats that use platform aligned page size.

Valid values

dbms.memory.pagecache.directio, a boolean

Default value

false

Table 208. dbms.memory.pagecache.flush.buffer.enabled

Description

Page cache can be configured to use a temporal buffer for flushing purposes. It is used to combine, if possible, sequence of several cache pages into one bigger buffer to minimize the number of individual IOPS performed and better utilization of available I/O resources, especially when those are restricted.

Valid values

dbms.memory.pagecache.flush.buffer.enabled, a boolean

Dynamic

true

Default value

false

Table 209. dbms.memory.pagecache.flush.buffer.size_in_pages

Description

Page cache can be configured to use a temporal buffer for flushing purposes. It is used to combine, if possible, sequence of several cache pages into one bigger buffer to minimize the number of individual IOPS performed and better utilization of available I/O resources, especially when those are restricted. Use this setting to configure individual file flush buffer size in pages (8KiB). To be able to utilize this buffer during page cache flushing, buffered flush should be enabled.

Valid values

dbms.memory.pagecache.flush.buffer.size_in_pages, an integer which is in the range 1 to 512

Dynamic

true

Default value

128

Table 210. dbms.memory.pagecache.scan.prefetchers

Description

The maximum number of worker threads to use for pre-fetching data when doing sequential scans. Set to '0' to disable pre-fetching for scans.

Valid values

dbms.memory.pagecache.scan.prefetchers, an integer which is in the range 0 to 255

Default value

4

Table 211. dbms.memory.pagecache.size

Description

The amount of memory to use for mapping the store files, in bytes (or kilobytes with the 'k' suffix, megabytes with 'm' and gigabytes with 'g'). If Neo4j is running on a dedicated server, then it is generally recommended to leave about 2-4 gigabytes for the operating system, give the JVM enough heap to hold all your transaction state and query context, and then leave the rest for the page cache. If no page cache memory is configured, then a heuristic setting is computed based on available system resources.

Valid values

dbms.memory.pagecache.size, a string

Table 212. dbms.memory.pagecache.swapper

Description

This setting is not used anymore.

Valid values

dbms.memory.pagecache.swapper, a string

Deprecated

The dbms.memory.pagecache.swapper configuration setting has been deprecated.

Table 213. dbms.memory.pagecache.warmup.enable

Description

Page cache can be configured to perform usage sampling of loaded pages that can be used to construct active load profile. According to that profile pages can be reloaded on the restart, replication, etc. This setting allows disabling that behavior. This feature is available in Neo4j Enterprise Edition.

Valid values

dbms.memory.pagecache.warmup.enable, a boolean

Default value

true

Table 214. dbms.memory.pagecache.warmup.preload

Description

Page cache warmup can be configured to prefetch files, preferably when cache size is bigger than store size. Files to be prefetched can be filtered by 'dbms.memory.pagecache.warmup.preload.allowlist'. Enabling this disables warmup by profile.

Valid values

dbms.memory.pagecache.warmup.preload, a boolean

Default value

false

Table 215. dbms.memory.pagecache.warmup.preload.allowlist

Description

Page cache warmup prefetch file allowlist regex. By default matches all files.

Valid values

dbms.memory.pagecache.warmup.preload.allowlist, a string

Default value

.*

Table 216. dbms.memory.pagecache.warmup.preload.whitelist

Description

Page cache warmup prefetch file whitelist regex. By default matches all files. Deprecated, use 'dbms.memory.pagecache.warmup.preload.allowlist'.

Valid values

dbms.memory.pagecache.warmup.preload.whitelist, a string

Default value

.*

Deprecated

The dbms.memory.pagecache.warmup.preload.whitelist configuration setting has been deprecated.

Table 217. dbms.memory.pagecache.warmup.profile.interval

Description

The profiling frequency for the page cache. Accurate profiles allow the page cache to do active warmup after a restart, reducing the mean time to performance. This feature is available in Neo4j Enterprise Edition.

Valid values

dbms.memory.pagecache.warmup.profile.interval, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

1m

Table 218. dbms.memory.tracking.enable

Description

Enable off heap and on heap memory tracking. Should not be set to false for clusters.

Valid values

dbms.memory.tracking.enable, a boolean

Default value

true

Table 219. dbms.memory.transaction.database_max_size

Description

Limit the amount of memory that all transactions in one database can consume, in bytes (or kilobytes with the 'k' suffix, megabytes with 'm' and gigabytes with 'g'). Zero means 'unlimited'.

Valid values

dbms.memory.transaction.database_max_size, a byte size (valid multipliers are B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB) which is minimum 10.00MiB or is 0B

Dynamic

true

Default value

0B

Table 220. dbms.memory.transaction.global_max_size

Description

Limit the amount of memory that all of the running transactions can consume, in bytes (or kilobytes with the 'k' suffix, megabytes with 'm' and gigabytes with 'g'). Zero means 'unlimited'.

Valid values

dbms.memory.transaction.global_max_size, a byte size (valid multipliers are B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB) which is minimum 10.00MiB or is 0B

Dynamic

true

Default value

0B

Table 221. dbms.memory.transaction.max_size

Description

Limit the amount of memory that a single transaction can consume, in bytes (or kilobytes with the 'k' suffix, megabytes with 'm' and gigabytes with 'g'). Zero means 'largest possible value'. When dbms.mode=CORE or dbms.mode=READ_REPLICA or dbms.clustering.enable=true this is '2G', in other cases this is 'unlimited'.

Valid values

dbms.memory.transaction.max_size, a byte size (valid multipliers are B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB) which is minimum 1.00MiB or is 0B and depends on dbms.mode. If dbms.mode is CORE or is READ_REPLICA then it is maximum 2.00GiB otherwise it depends on dbms.clustering.enable. If dbms.clustering.enable is true then it is maximum 2.00GiB otherwise it is unconstrained..

Dynamic

true

Default value

0B

Table 222. dbms.mode

Description

Configure the operating mode of the database — 'SINGLE' for stand-alone operation, 'CORE' for operating as a core member of a Causal Cluster, or 'READ_REPLICA' for operating as a read replica member of a Causal Cluster. Only SINGLE mode is allowed in Community.

Valid values

dbms.mode, one of [SINGLE, CORE, READ_REPLICA]

Default value

SINGLE

Table 223. dbms.netty.ssl.provider

Description

Netty SSL provider.

Valid values

dbms.netty.ssl.provider, one of [JDK, OPENSSL, OPENSSL_REFCNT]

Default value

JDK

Table 224. dbms.panic.shutdown_on_panic

Description

If there is a Database Management System Panic (an irrecoverable error) should the neo4j process shut down or continue running. Following a DbMS panic it is likely that a significant amount of functionality will be lost. Recovering full functionality will require a Neo4j restart.

Valid values

dbms.panic.shutdown_on_panic, a boolean

Default value

false

Table 225. dbms.query_cache_size

Description

The number of Cypher query execution plans that are cached.

Valid values

dbms.query_cache_size, an integer which is minimum 0

Default value

1000

Table 226. dbms.read_only

Description

Only allow read operations from this Neo4j instance. This mode still requires write access to the directory for lock purposes. Replaced by: dbms.databases.default_to_read_only, dbms.databases.read_only, dbms.databases.writable.

Valid values

dbms.read_only, a boolean

Default value

false

Deprecated

The dbms.read_only configuration setting has been deprecated.

Table 227. dbms.reconciler.max_backoff

Description

Defines the maximum amount of time to wait before retrying after the dbms fails to reconcile a database to its desired state.

Valid values

dbms.reconciler.max_backoff, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's') which is minimum 1m

Default value

1h

Table 228. dbms.reconciler.max_parallelism

Description

Defines the level of parallelism employed by the reconciler. By default the parallelism equals the number of available processors or 8 (whichever is smaller). If configured as 0, the parallelism of the reconciler will be unbounded.

Valid values

dbms.reconciler.max_parallelism, an integer which is minimum 0

Default value

8

Table 229. dbms.reconciler.may_retry

Description

Defines whether the dbms may retry reconciling a database to its desired state.

Valid values

dbms.reconciler.may_retry, a boolean

Default value

false

Table 230. dbms.reconciler.min_backoff

Description

Defines the minimum amount of time to wait before retrying after the dbms fails to reconcile a database to its desired state.

Valid values

dbms.reconciler.min_backoff, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's') which is minimum 1s

Default value

2s

Table 231. dbms.record_format

Description

Database record format. Valid values are standard, aligned, or high_limit. The aligned format is essentially the standard format with some minimal padding at the end of pages such that a single record will never cross a page boundary. The high_limit format is available for Enterprise Edition only. It is required if you have a graph that is larger than 34 billion nodes, 34 billion relationships, or 68 billion properties. A change of the record format is irreversible. Certain operations may suffer from a performance penalty of up to 10%, which is why this format is not switched on by default. However, if you want to change the configured record format value, you must also set dbms.allow_upgrade=true, because the setting implies a one-way store format migration.

Valid values

dbms.record_format, a string

Default value

aligned for new databases, latest version of current format for existing databases

Table 232. dbms.recovery.fail_on_missing_files

Description

If true, Neo4j will abort recovery if transaction log files are missing. Setting this to false will allow Neo4j to create new empty missing files for the already existing database, but the integrity of the database might be compromised.

Valid values

dbms.recovery.fail_on_missing_files, a boolean

Default value

true

Table 233. dbms.relationship_grouping_threshold

Description

Relationship count threshold for considering a node to be dense.

Valid values

dbms.relationship_grouping_threshold, an integer which is minimum 1

Default value

50

Table 234. dbms.rest.transaction.idle_timeout

Description

Timeout for idle transactions in the REST endpoint.

Valid values

dbms.rest.transaction.idle_timeout, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

1m

Table 235. dbms.routing.advertised_address

Description

The advertised address for the intra-cluster routing connector.

Valid values

dbms.routing.advertised_address, a socket address. If missing port or hostname it is acquired from dbms.default_advertised_address

Default value

:7688

Table 236. dbms.routing.client_side.enforce_for_domains

Description

Always use client side routing (regardless of the default router) for neo4j:// protocol connections to these domains. A comma seperated list of domains. Wildcards (*) are supported.

Valid values

dbms.routing.client_side.enforce_for_domains, a ',' separated set with elements of type 'a string'.

Dynamic

true

Default value

Table 237. dbms.routing.default_router

Description

Use server side routing by default for neo4j:// protocol connections.

Valid values

dbms.routing.default_router, one of [SERVER, CLIENT]

Default value

CLIENT

Table 238. dbms.routing.driver.api

Description

Determines which driver API will be used. ASYNC must be used when the remote instance is 3.5.

Valid values

dbms.routing.driver.api, one of [RX, ASYNC]

Default value

RX

Table 239. dbms.routing.driver.connection.connect_timeout

Description

Socket connection timeout. A timeout of zero is treated as an infinite timeout and will be bound by the timeout configured on the operating system level.

Valid values

dbms.routing.driver.connection.connect_timeout, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

5s

Table 240. dbms.routing.driver.connection.max_lifetime

Description

Pooled connections older than this threshold will be closed and removed from the pool. Setting this option to a low value will cause a high connection churn and might result in a performance hit. It is recommended to set maximum lifetime to a slightly smaller value than the one configured in network equipment (load balancer, proxy, firewall, etc. can also limit maximum connection lifetime). Zero and negative values result in lifetime not being checked.

Valid values

dbms.routing.driver.connection.max_lifetime, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

1h

Table 241. dbms.routing.driver.connection.pool.acquisition_timeout

Description

Maximum amount of time spent attempting to acquire a connection from the connection pool. This timeout only kicks in when all existing connections are being used and no new connections can be created because maximum connection pool size has been reached. Error is raised when connection can’t be acquired within configured time. Negative values are allowed and result in unlimited acquisition timeout. Value of 0 is allowed and results in no timeout and immediate failure when connection is unavailable.

Valid values

dbms.routing.driver.connection.pool.acquisition_timeout, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

1m

Table 242. dbms.routing.driver.connection.pool.idle_test

Description

Pooled connections that have been idle in the pool for longer than this timeout will be tested before they are used again, to ensure they are still alive. If this option is set too low, an additional network call will be incurred when acquiring a connection, which causes a performance hit. If this is set high, no longer live connections might be used which might lead to errors. Hence, this parameter tunes a balance between the likelihood of experiencing connection problems and performance Normally, this parameter should not need tuning. Value 0 means connections will always be tested for validity.

Valid values

dbms.routing.driver.connection.pool.idle_test, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

No connection liveliness check is done by default.

Table 243. dbms.routing.driver.connection.pool.max_size

Description

Maximum total number of connections to be managed by a connection pool. The limit is enforced for a combination of a host and user. Negative values are allowed and result in unlimited pool. Value of 0is not allowed.

Valid values

dbms.routing.driver.connection.pool.max_size, an integer

Default value

Unlimited

Table 244. dbms.routing.driver.logging.level

Description

Sets level for driver internal logging.

Valid values

dbms.routing.driver.logging.level, one of [DEBUG, INFO, WARN, ERROR, NONE]

Default value

Value of dbms.logs.debug.level

Table 245. dbms.routing.enabled

Description

Enable intra-cluster routing using an additional bolt connector.

Valid values

dbms.routing.enabled, a boolean

Default value

false

Table 246. dbms.routing.listen_address

Description

The address the routing connector should bind to.

Valid values

dbms.routing.listen_address, a socket address. If missing port or hostname it is acquired from dbms.default_listen_address

Default value

:7688

Table 247. dbms.routing_ttl

Description

How long callers should cache the response of the routing procedure dbms.routing.getRoutingTable()

Valid values

dbms.routing_ttl, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's') which is minimum 1s

Default value

5m

Table 248. dbms.security.allow_csv_import_from_file_urls

Description

Determines if Cypher will allow using file URLs when loading data using LOAD CSV. Setting this value to false will cause Neo4j to fail LOAD CSV clauses that load data from the file system.

Valid values

dbms.security.allow_csv_import_from_file_urls, a boolean

Default value

true

Table 249. dbms.security.auth_cache_max_capacity

Description

The maximum capacity for authentication and authorization caches (respectively).

Valid values

dbms.security.auth_cache_max_capacity, an integer

Default value

10000

Table 250. dbms.security.auth_cache_ttl

Description

The time to live (TTL) for cached authentication and authorization info when using external auth providers (LDAP or plugin). Setting the TTL to 0 will disable auth caching. Disabling caching while using the LDAP auth provider requires the use of an LDAP system account for resolving authorization information.

Valid values

dbms.security.auth_cache_ttl, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

10m

Table 251. dbms.security.auth_cache_use_ttl

Description

Enable time-based eviction of the authentication and authorization info cache for external auth providers (LDAP or plugin). Disabling this setting will make the cache live forever and only be evicted when dbms.security.auth_cache_max_capacity is exceeded.

Valid values

dbms.security.auth_cache_use_ttl, a boolean

Default value

true

Table 252. dbms.security.auth_enabled

Description

Enable auth requirement to access Neo4j.

Valid values

dbms.security.auth_enabled, a boolean

Default value

true

Table 253. dbms.security.auth_lock_time

Description

The amount of time user account should be locked after a configured number of unsuccessful authentication attempts. The locked out user will not be able to log in until the lock period expires, even if correct credentials are provided. Setting this configuration option to a low value is not recommended because it might make it easier for an attacker to brute force the password.

Valid values

dbms.security.auth_lock_time, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's') which is minimum 0s

Default value

5s

Table 254. dbms.security.auth_max_failed_attempts

Description

The maximum number of unsuccessful authentication attempts before imposing a user lock for the configured amount of time, as defined by dbms.security.auth_lock_time.The locked out user will not be able to log in until the lock period expires, even if correct credentials are provided. Setting this configuration option to values less than 3 is not recommended because it might make it easier for an attacker to brute force the password.

Valid values

dbms.security.auth_max_failed_attempts, an integer which is minimum 0

Default value

3

Table 255. dbms.security.authentication_providers

Description

A list of security authentication providers containing the users and roles. This can be any of the built-in native or ldap providers, or it can be an externally provided plugin, with a custom name prefixed by plugin-, i.e. plugin-<AUTH_PROVIDER_NAME>. They will be queried in the given order when login is attempted.

Valid values

dbms.security.authentication_providers, a ',' separated list with elements of type 'a string'.

Default value

native

Table 256. dbms.security.authorization_providers

Description

A list of security authorization providers containing the users and roles. This can be any of the built-in native or ldap providers, or it can be an externally provided plugin, with a custom name prefixed by plugin-, i.e. plugin-<AUTH_PROVIDER_NAME>. They will be queried in the given order when login is attempted.

Valid values

dbms.security.authorization_providers, a ',' separated list with elements of type 'a string'.

Default value

native

Table 257. dbms.security.causal_clustering_status_auth_enabled

Description

Require authorization for access to the Causal Clustering status endpoints.

Valid values

dbms.security.causal_clustering_status_auth_enabled, a boolean

Default value

true

Table 258. dbms.security.http_access_control_allow_origin

Description

Value of the Access-Control-Allow-Origin header sent over any HTTP or HTTPS connector. This defaults to '*', which allows broadest compatibility. Note that any URI provided here limits HTTP/HTTPS access to that URI only.

Valid values

dbms.security.http_access_control_allow_origin, a string

Default value

*

Table 259. dbms.security.http_auth_allowlist

Description

Defines an allowlist of http paths where Neo4j authentication is not required.

Valid values

dbms.security.http_auth_allowlist, a ',' separated list with elements of type 'a string'.

Default value

/,/browser.*

Table 260. dbms.security.http_auth_whitelist

Description

Defines a whitelist of http paths where Neo4j authentication is not required. Deprecated, use dbms.security.http_auth_allowlist

Valid values

dbms.security.http_auth_whitelist, a ',' separated list with elements of type 'a string'.

Default value

/,/browser.*

Deprecated

The dbms.security.http_auth_whitelist configuration setting has been deprecated.

Table 261. dbms.security.http_strict_transport_security

Description

Value of the HTTP Strict-Transport-Security (HSTS) response header. This header tells browsers that a webpage should only be accessed using HTTPS instead of HTTP. It is attached to every HTTPS response. Setting is not set by default so 'Strict-Transport-Security' header is not sent. Value is expected to contain directives like 'max-age', 'includeSubDomains' and 'preload'.

Valid values

dbms.security.http_strict_transport_security, a string

Table 262. dbms.security.ldap.authentication.attribute

Description

The attribute to use when looking up users. Using this setting requires dbms.security.ldap.authentication.search_for_attribute to be true and thus dbms.security.ldap.authorization.system_username and dbms.security.ldap.authorization.system_password to be configured.

Valid values

dbms.security.ldap.authentication.attribute, a string which matches the pattern [A-Za-z0-9-]* (has to be a valid LDAP attribute name, only containing letters [A-Za-z], digits [0-9] and hyphens [-].)

Dynamic

true

Default value

samaccountname

Table 263. dbms.security.ldap.authentication.cache_enabled

Description

Determines if the result of authentication via the LDAP server should be cached or not. Caching is used to limit the number of LDAP requests that have to be made over the network for users that have already been authenticated successfully. A user can be authenticated against an existing cache entry (instead of via an LDAP server) as long as it is alive (see dbms.security.auth_cache_ttl). An important consequence of setting this to true is that Neo4j then needs to cache a hashed version of the credentials in order to perform credentials matching. This hashing is done using a cryptographic hash function together with a random salt. Preferably a conscious decision should be made if this method is considered acceptable by the security standards of the organization in which this Neo4j instance is deployed.

Valid values

dbms.security.ldap.authentication.cache_enabled, a boolean

Default value

true

Table 264. dbms.security.ldap.authentication.mechanism

Description

LDAP authentication mechanism. This is one of simple or a SASL mechanism supported by JNDI, for example DIGEST-MD5. simple is basic username and password authentication and SASL is used for more advanced mechanisms. See RFC 2251 LDAPv3 documentation for more details.

Valid values

dbms.security.ldap.authentication.mechanism, a string

Default value

simple

Table 265. dbms.security.ldap.authentication.search_for_attribute

Description

Perform authentication by searching for an unique attribute of a user. Using this setting requires dbms.security.ldap.authorization.system_username and dbms.security.ldap.authorization.system_password to be configured.

Valid values

dbms.security.ldap.authentication.search_for_attribute, a boolean

Default value

false

Table 266. dbms.security.ldap.authentication.use_samaccountname

Description

Perform authentication by searching for an unique attribute of a user. This setting is deprecated and has been replaced with dbms.security.ldap.authentication.search_for_attribute.

Valid values

dbms.security.ldap.authentication.use_samaccountname, a boolean

Default value

false

Deprecated

The dbms.security.ldap.authentication.use_samaccountname configuration setting has been deprecated.

Table 267. dbms.security.ldap.authentication.user_dn_template

Description

LDAP user DN template. An LDAP object is referenced by its distinguished name (DN), and a user DN is an LDAP fully-qualified unique user identifier. This setting is used to generate an LDAP DN that conforms with the LDAP directory’s schema from the user principal that is submitted with the authentication token when logging in. The special token {0} is a placeholder where the user principal will be substituted into the DN string.

Valid values

dbms.security.ldap.authentication.user_dn_template, a string which Must be a string containing '{0}' to understand where to insert the runtime authentication principal.

Dynamic

true

Default value

uid={0},ou=users,dc=example,dc=com

Table 268. dbms.security.ldap.authorization.access_permitted_group

Description

The LDAP group to which a user must belong to get any access to the system.Set this to restrict access to a subset of LDAP users belonging to a particular group. If this is not set, any user to successfully authenticate via LDAP will have access to the PUBLIC role and any other roles assigned to them via dbms.security.ldap.authorization.group_to_role_mapping.

Valid values

dbms.security.ldap.authorization.access_permitted_group, a string

Dynamic

true

Default value

Table 269. dbms.security.ldap.authorization.group_membership_attributes

Description

A list of attribute names on a user object that contains groups to be used for mapping to roles when LDAP authorization is enabled.

Valid values

dbms.security.ldap.authorization.group_membership_attributes, a ',' separated list with elements of type 'a string'. which Can not be empty

Dynamic

true

Default value

memberOf

Table 270. dbms.security.ldap.authorization.group_to_role_mapping

Description

An authorization mapping from LDAP group names to Neo4j role names. The map should be formatted as a semicolon separated list of key-value pairs, where the key is the LDAP group name and the value is a comma separated list of corresponding role names. For example: group1=role1;group2=role2;group3=role3,role4,role5 You could also use whitespaces and quotes around group names to make this mapping more readable, for example:

dbms.security.ldap.authorization.group_to_role_mapping=\
         "cn=Neo4j Read Only,cn=users,dc=example,dc=com"      = reader;    \
         "cn=Neo4j Read-Write,cn=users,dc=example,dc=com"     = publisher; \
         "cn=Neo4j Schema Manager,cn=users,dc=example,dc=com" = architect; \
         "cn=Neo4j Administrator,cn=users,dc=example,dc=com"  = admin

Valid values

dbms.security.ldap.authorization.group_to_role_mapping, a string which must be semicolon separated list of key-value pairs or empty

Dynamic

true

Default value

Table 271. dbms.security.ldap.authorization.system_password

Description

An LDAP system account password to use for authorization searches when dbms.security.ldap.authorization.use_system_account is true.

Valid values

dbms.security.ldap.authorization.system_password, a secure string

Table 272. dbms.security.ldap.authorization.system_username

Description

An LDAP system account username to use for authorization searches when dbms.security.ldap.authorization.use_system_account is true. Note that the dbms.security.ldap.authentication.user_dn_template will not be applied to this username, so you may have to specify a full DN.

Valid values

dbms.security.ldap.authorization.system_username, a string

Table 273. dbms.security.ldap.authorization.use_system_account

Description

Perform LDAP search for authorization info using a system account instead of the user’s own account. If this is set to false (default), the search for group membership will be performed directly after authentication using the LDAP context bound with the user’s own account. The mapped roles will be cached for the duration of dbms.security.auth_cache_ttl, and then expire, requiring re-authentication. To avoid frequently having to re-authenticate sessions you may want to set a relatively long auth cache expiration time together with this option. NOTE: This option will only work if the users are permitted to search for their own group membership attributes in the directory. If this is set to true, the search will be performed using a special system account user with read access to all the users in the directory. You need to specify the username and password using the settings dbms.security.ldap.authorization.system_username and dbms.security.ldap.authorization.system_password with this option. Note that this account only needs read access to the relevant parts of the LDAP directory and does not need to have access rights to Neo4j, or any other systems.

Valid values

dbms.security.ldap.authorization.use_system_account, a boolean

Default value

false

Table 274. dbms.security.ldap.authorization.user_search_base

Description

The name of the base object or named context to search for user objects when LDAP authorization is enabled. A common case is that this matches the last part of dbms.security.ldap.authentication.user_dn_template.

Valid values

dbms.security.ldap.authorization.user_search_base, a string which Can not be empty

Dynamic

true

Default value

ou=users,dc=example,dc=com

Table 275. dbms.security.ldap.authorization.user_search_filter

Description

The LDAP search filter to search for a user principal when LDAP authorization is enabled. The filter should contain the placeholder token {0} which will be substituted for the user principal.

Valid values

dbms.security.ldap.authorization.user_search_filter, a string

Dynamic

true

Default value

(&(objectClass=*)(uid={0}))

Table 276. dbms.security.ldap.connection_timeout

Description

The timeout for establishing an LDAP connection. If a connection with the LDAP server cannot be established within the given time the attempt is aborted. A value of 0 means to use the network protocol’s (i.e., TCP’s) timeout value.

Valid values

dbms.security.ldap.connection_timeout, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

30s

Table 277. dbms.security.ldap.host

Description

URL of LDAP server to use for authentication and authorization. The format of the setting is <protocol>://<hostname>:<port>, where hostname is the only required field. The supported values for protocol are ldap (default) and ldaps. The default port for ldap is 389 and for ldaps 636. For example: ldaps://ldap.example.com:10389. You may want to consider using STARTTLS (dbms.security.ldap.use_starttls) instead of LDAPS for secure connections, in which case the correct protocol is ldap.

Valid values

dbms.security.ldap.host, a string

Default value

localhost

Table 278. dbms.security.ldap.read_timeout

Description

The timeout for an LDAP read request (i.e. search). If the LDAP server does not respond within the given time the request will be aborted. A value of 0 means wait for a response indefinitely.

Valid values

dbms.security.ldap.read_timeout, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

30s

Table 279. dbms.security.ldap.referral

Description

The LDAP referral behavior when creating a connection. This is one of follow, ignore or throw. * follow automatically follows any referrals * ignore ignores any referrals * throw throws an exception, which will lead to authentication failure.

Valid values

dbms.security.ldap.referral, a string

Default value

follow

Table 280. dbms.security.ldap.use_starttls

Description

Use secure communication with the LDAP server using opportunistic TLS. First an initial insecure connection will be made with the LDAP server, and a STARTTLS command will be issued to negotiate an upgrade of the connection to TLS before initiating authentication.

Valid values

dbms.security.ldap.use_starttls, a boolean

Default value

false

Table 281. dbms.security.log_successful_authentication

Description

Set to log successful authentication events to the security log. If this is set to false only failed authentication events will be logged, which could be useful if you find that the successful events spam the logs too much, and you do not require full auditing capability.

Valid values

dbms.security.log_successful_authentication, a boolean

Default value

true

Table 282. dbms.security.procedures.allowlist

Description

A list of procedures (comma separated) that are to be loaded. The list may contain both fully-qualified procedure names, and partial names with the wildcard '*'. If this setting is left empty no procedures will be loaded.

Valid values

dbms.security.procedures.allowlist, a ',' separated list with elements of type 'a string'.

Default value

*

Table 283. dbms.security.procedures.default_allowed

Description

The default role that can execute all procedures and user-defined functions that are not covered by the dbms.security.procedures.roles setting. This setting (if not empty string) will be translated to 'GRANT EXECUTE BOOSTED PROCEDURE *' and 'GRANT EXECUTE BOOSTED FUNCTION *' for that role. If `dbms.security.procedures.roles`is not empty, any procedure or function that this role is not mapped to will result in a 'DENY EXECUTE BOOSTED PROCEDURE name' and 'DENY EXECUTE BOOSTED FUNCTION name' for this role. Any privilege mapped in this way cannot be revoked, instead the config must be changed and will take effect after a restart.Deprecated: Replaced by EXECUTE PROCEDURE, EXECUTE BOOSTED PROCEDURE, EXECUTE FUNCTION and EXECUTE BOOSTED FUNCTION privileges.

Valid values

dbms.security.procedures.default_allowed, a string

Default value

Deprecated

The dbms.security.procedures.default_allowed configuration setting has been deprecated.

Table 284. dbms.security.procedures.roles

Description

This provides a finer level of control over which roles can execute procedures than the dbms.security.procedures.default_allowed setting. For example: dbms.security.procedures.roles=apoc.convert.*:reader;apoc.load.json*:writer;apoc.trigger.add:TriggerHappy will allow the role reader to execute all procedures in the apoc.convert namespace, the role writer to execute all procedures in the apoc.load namespace that starts with json and the role TriggerHappy to execute the specific procedure apoc.trigger.add. Procedures not matching any of these patterns will be subject to the dbms.security.procedures.default_allowed setting. This setting (if not empty string) will be translated to 'GRANT EXECUTE BOOSTED PROCEDURE name' and 'GRANT EXECUTE BOOSTED FUNCTION name' privileges for the mapped roles. Any privilege mapped in this way cannot be revoked, instead the config must be changed and will take effect after a restart.Deprecated: Replaced by EXECUTE PROCEDURE, EXECUTE BOOSTED PROCEDURE, EXECUTE FUNCTION and EXECUTE BOOSTED FUNCTION privileges.

Valid values

dbms.security.procedures.roles, a string

Default value

Deprecated

The dbms.security.procedures.roles configuration setting has been deprecated.

Table 285. dbms.security.procedures.unrestricted

Description

A list of procedures and user defined functions (comma separated) that are allowed full access to the database. The list may contain both fully-qualified procedure names, and partial names with the wildcard '*'. Note that this enables these procedures to bypass security. Use with caution.

Valid values

dbms.security.procedures.unrestricted, a ',' separated list with elements of type 'a string'.

Default value

Table 286. dbms.security.procedures.whitelist

Description

A list of procedures (comma separated) that are to be loaded. The list may contain both fully-qualified procedure names, and partial names with the wildcard '*'. If this setting is left empty no procedures will be loaded. Deprecated, use dbms.security.procedures.allowlist

Valid values

dbms.security.procedures.whitelist, a ',' separated list with elements of type 'a string'.

Default value

*

Deprecated

The dbms.security.procedures.whitelist configuration setting has been deprecated.

Table 287. dbms.shutdown_transaction_end_timeout

Description

The maximum amount of time to wait for running transactions to complete before allowing initiated database shutdown to continue.

Valid values

dbms.shutdown_transaction_end_timeout, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

10s

Table 288. dbms.store.files.preallocate

Description

Specify if Neo4j should try to preallocate store files as they grow.

Valid values

dbms.store.files.preallocate, a boolean

Default value

true

Table 289. dbms.threads.worker_count

Description

Number of Neo4j worker threads. This setting is only valid for REST, and does not influence bolt-server. It sets the amount of worker threads for the Jetty server used by neo4j-server. This option can be tuned when you plan to execute multiple, concurrent REST requests, with the aim of getting more throughput from the database. Your OS might enforce a lower limit than the maximum value specified here.

Valid values

dbms.threads.worker_count, an integer which is in the range 1 to 44738

Default value

Number of available processors, or 500 for machines which have more than 500 processors.

Table 290. dbms.track_query_allocation

Description

Enables or disables tracking of how many bytes are allocated by the execution of a query. If enabled, calling dbms.listQueries will display the allocated bytes. This can also be logged in the query log by using dbms.logs.query.allocation_logging_enabled.

Valid values

dbms.track_query_allocation, a boolean

Dynamic

true

Default value

true

Table 291. dbms.track_query_cpu_time

Description

Enables or disables tracking of how much time a query spends actively executing on the CPU. Calling dbms.listQueries will display the time. This can also be logged in the query log by using dbms.logs.query.time_logging_enabled.

Valid values

dbms.track_query_cpu_time, a boolean

Dynamic

true

Default value

false

Table 292. dbms.transaction.bookmark_ready_timeout

Description

The maximum amount of time to wait for the database state represented by the bookmark.

Valid values

dbms.transaction.bookmark_ready_timeout, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's') which is minimum 1s

Dynamic

true

Default value

30s

Table 293. dbms.transaction.concurrent.maximum

Description

The maximum number of concurrently running transactions. If set to 0, limit is disabled.

Valid values

dbms.transaction.concurrent.maximum, an integer

Dynamic

true

Default value

1000

Table 294. dbms.transaction.monitor.check.interval

Description

Configures the time interval between transaction monitor checks. Determines how often monitor thread will check transaction for timeout.

Valid values

dbms.transaction.monitor.check.interval, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

2s

Table 295. dbms.transaction.sampling.percentage

Description

Transaction sampling percentage.

Valid values

dbms.transaction.sampling.percentage, an integer which is in the range 1 to 100

Dynamic

true

Default value

5

Table 296. dbms.transaction.timeout

Description

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

Valid values

dbms.transaction.timeout, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Dynamic

true

Default value

0s

Table 297. dbms.transaction.tracing.level

Description

Transaction creation tracing level.

Valid values

dbms.transaction.tracing.level, one of [DISABLED, SAMPLE, ALL]

Dynamic

true

Default value

DISABLED

Table 298. dbms.tx_log.preallocate

Description

Specify if Neo4j should try to preallocate logical log file in advance.

Valid values

dbms.tx_log.preallocate, a boolean

Dynamic

true

Default value

true

Table 299. dbms.tx_log.rotation.retention_policy

Description

Tell Neo4j how long logical transaction logs should be kept to backup the database.For example, "10 days" will prune logical logs that only contain transactions older than 10 days.Alternatively, "100k txs" will keep the 100k latest transactions from each database and prune any older transactions.

Valid values

dbms.tx_log.rotation.retention_policy, a string which matches the pattern ^(true|keep_all|false|keep_none|(\d+[KkMmGg]?( (files|size|txs|entries|hours|days))))$ (Must be true or keep_all, false or keep_none, or of format <number><optional unit> <type>. Valid units are K, M and G. Valid types are files, size, txs, entries, hours and days. For example, 100M size will limit logical log space on disk to 100MB per database,and 200K txs will limit the number of transactions kept to 200 000 per database.)

Dynamic

true

Default value

7 days

Table 300. dbms.tx_log.rotation.size

Description

Specifies at which file size the logical log will auto-rotate. Minimum accepted value is 128 KiB.

Valid values

dbms.tx_log.rotation.size, a byte size (valid multipliers are B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB) which is minimum 128.00KiB

Dynamic

true

Default value

250.00MiB

Table 301. dbms.tx_state.memory_allocation

Description

Defines whether memory for transaction state should be allocated on- or off-heap. Note that for small transactions you can gain up to 25% write speed by setting it to ON_HEAP.

Valid values

dbms.tx_state.memory_allocation, one of [ON_HEAP, OFF_HEAP]

Default value

OFF_HEAP

Table 302. dbms.unmanaged_extension_classes

Description

Comma-separated list of <classname>=<mount point> for unmanaged extensions.

Valid values

dbms.unmanaged_extension_classes, a ',' separated list with elements of type '<classname>=<mount point> string'.

Default value

Table 303. dbms.upgrade_max_processors

Description

Max number of processors used when upgrading the store. Defaults to the number of processors available to the JVM. There is a certain amount of minimum threads needed so for that reason there is no lower bound for this value. For optimal performance this value shouldn’t be greater than the number of available processors.

Valid values

dbms.upgrade_max_processors, an integer which is minimum 0

Dynamic

true

Default value

0

Table 304. dbms.windows_service_name

Description

Name of the Windows Service.

Valid values

dbms.windows_service_name, a string

Default value

neo4j

Table 305. fabric.database.name

Description

Name of the Fabric database. Only one Fabric database is currently supported per Neo4j instance.

Valid values

fabric.database.name, A valid database name. Containing only alphabetic characters, numbers, dots and dashes, with a length between 3 and 63 characters. It should be starting with an alphabetic character but not with the name 'system'.

Table 306. fabric.driver.api

Description

Determines which driver API will be used. ASYNC must be used when the remote instance is 3.5.

Valid values

fabric.driver.api, one of [RX, ASYNC]

Default value

RX

Table 307. fabric.driver.connection.connect_timeout

Description

Socket connection timeout. A timeout of zero is treated as an infinite timeout and will be bound by the timeout configured on the operating system level.

Valid values

fabric.driver.connection.connect_timeout, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

5s

Table 308. fabric.driver.connection.max_lifetime

Description

Pooled connections older than this threshold will be closed and removed from the pool. Setting this option to a low value will cause a high connection churn and might result in a performance hit. It is recommended to set maximum lifetime to a slightly smaller value than the one configured in network equipment (load balancer, proxy, firewall, etc. can also limit maximum connection lifetime). Zero and negative values result in lifetime not being checked.

Valid values

fabric.driver.connection.max_lifetime, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

1h

Table 309. fabric.driver.connection.pool.acquisition_timeout

Description

Maximum amount of time spent attempting to acquire a connection from the connection pool. This timeout only kicks in when all existing connections are being used and no new connections can be created because maximum connection pool size has been reached. Error is raised when connection can’t be acquired within configured time. Negative values are allowed and result in unlimited acquisition timeout. Value of 0 is allowed and results in no timeout and immediate failure when connection is unavailable.

Valid values

fabric.driver.connection.pool.acquisition_timeout, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

1m

Table 310. fabric.driver.connection.pool.idle_test

Description

Pooled connections that have been idle in the pool for longer than this timeout will be tested before they are used again, to ensure they are still alive. If this option is set too low, an additional network call will be incurred when acquiring a connection, which causes a performance hit. If this is set high, no longer live connections might be used which might lead to errors. Hence, this parameter tunes a balance between the likelihood of experiencing connection problems and performance Normally, this parameter should not need tuning. Value 0 means connections will always be tested for validity.

Valid values

fabric.driver.connection.pool.idle_test, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

No connection liveliness check is done by default.

Table 311. fabric.driver.connection.pool.max_size

Description

Maximum total number of connections to be managed by a connection pool. The limit is enforced for a combination of a host and user. Negative values are allowed and result in unlimited pool. Value of 0is not allowed.

Valid values

fabric.driver.connection.pool.max_size, an integer

Default value

Unlimited

Table 312. fabric.driver.logging.level

Description

Sets level for driver internal logging.

Valid values

fabric.driver.logging.level, one of [DEBUG, INFO, WARN, ERROR, NONE]

Default value

Value of dbms.logs.debug.level

Table 313. fabric.routing.servers

Description

A comma-separated list of Fabric instances that form a routing group. A driver will route transactions to available routing group members. A Fabric instance is represented by its Bolt connector address.

Valid values

fabric.routing.servers, a ',' separated list with elements of type 'a socket address'.

Dynamic

true

Table 314. fabric.routing.ttl

Description

The time to live (TTL) of a routing table for fabric routing group.

Valid values

fabric.routing.ttl, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

1m

Table 315. fabric.stream.buffer.low_watermark

Description

Number of records in prefetching buffer that will trigger prefetching again. This is strongly related to fabric.stream.buffer.size

Valid values

fabric.stream.buffer.low_watermark, an integer which is minimum 0

Default value

300

Table 316. fabric.stream.buffer.size

Description

Maximal size of a buffer used for pre-fetching result records of remote queries. To compensate for latency to remote databases, the Fabric execution engine pre-fetches records needed for local executions. This limit is enforced per fabric query. If a fabric query uses multiple remote stream at the same time, this setting represents the maximal number of pre-fetched records counted together for all such remote streams.

Valid values

fabric.stream.buffer.size, an integer which is minimum 1

Default value

1000

Table 317. fabric.stream.concurrency

Description

Maximal concurrency within Fabric queries. Limits the number of iterations of each subquery that are executed concurrently. Higher concurrency may consume more memory and network resources simultaneously, while lower concurrency may force sequential execution, requiring more time.

Valid values

fabric.stream.concurrency, an integer which is minimum 1

Default value

The number of remote graphs

Table 318. metrics.bolt.messages.enabled

Description

Enable reporting metrics about Bolt Protocol message processing. Deprecated - use metrics.filter instead.

Valid values

metrics.bolt.messages.enabled, a boolean

Default value

false

Deprecated

The metrics.bolt.messages.enabled configuration setting has been deprecated.

Table 319. metrics.csv.enabled

Description

Set to true to enable exporting metrics to CSV files.

Valid values

metrics.csv.enabled, a boolean

Default value

true

Table 320. metrics.csv.interval

Description

The reporting interval for the CSV files. That is, how often new rows with numbers are appended to the CSV files.

Valid values

metrics.csv.interval, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

30s

Table 321. metrics.csv.rotation.compression

Description

Decides what compression to use for the csv history files.

Valid values

metrics.csv.rotation.compression, one of [NONE, ZIP, GZ]

Default value

NONE

Table 322. metrics.csv.rotation.keep_number

Description

Maximum number of history files for the csv files.

Valid values

metrics.csv.rotation.keep_number, an integer which is minimum 1

Default value

7

Table 323. metrics.csv.rotation.size

Description

The file size in bytes at which the csv files will auto-rotate. If set to zero then no rotation will occur. Accepts a binary suffix k, m or g.

Valid values

metrics.csv.rotation.size, a byte size (valid multipliers are B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB) which is in the range 0B to 8388608.00TiB

Default value

10.00MiB

Table 324. metrics.cypher.replanning.enabled

Description

Enable reporting metrics about number of occurred replanning events. Deprecated - use metrics.filter instead.

Valid values

metrics.cypher.replanning.enabled, a boolean

Default value

false

Deprecated

The metrics.cypher.replanning.enabled configuration setting has been deprecated.

Table 325. metrics.enabled

Description

Enable metrics. Setting this to false will to turn off all metrics.

Valid values

metrics.enabled, a boolean

Default value

true

Table 326. metrics.filter

Description

Specifies which metrics should be enabled by using a comma separated list of globbing patterns. Only the metrics matching the filter will be enabled. For example 'check_point,neo4j.page_cache.evictions' will enable any checkpoint metrics and the pagecache eviction metric.

Valid values

metrics.filter, a ',' separated list with elements of type 'A simple globbing pattern that can use '*' and '?'.'.

Default value

bolt.connections,bolt.messages_received,bolt.messages_started,dbms.pool.bolt.free,*dbms.pool.bolt.total_size,*dbms.pool.bolt.total_used,*dbms.pool.bolt.used_heap,*causal_clustering.core.is_leader,*causal_clustering.core.last_leader_message,*causal_clustering.core.replication_attempt,*causal_clustering.core.replication_fail,*check_point.duration,*check_point.total_time,*cypher.replan_events,*ids_in_use,pool.transaction..total_used,pool.transaction..used_heap,pool.transaction..used_native,store.size,transaction.active_read,*transaction.active_write,*transaction.committed,transaction.last_committed_tx_id,*transaction.peak_concurrent,*transaction.rollbacks,page_cache.hit,page_cache.page_faults,*page_cache.usage_ratio,*vm.file.descriptors.count,*vm.gc.time.,vm.heap.used,*vm.memory.buffer.direct.used,*vm.memory.pool.g1_eden_space,*vm.memory.pool.g1_old_gen,*vm.pause_time,*vm.thread,db.query.execution

Table 327. metrics.graphite.enabled

Description

Set to true to enable exporting metrics to Graphite.

Valid values

metrics.graphite.enabled, a boolean

Default value

false

Table 328. metrics.graphite.interval

Description

The reporting interval for Graphite. That is, how often to send updated metrics to Graphite.

Valid values

metrics.graphite.interval, a duration (Valid units are: 'ns', 'μs', 'ms', 's', 'm', 'h' and 'd'; default unit is 's')

Default value

30s

Table 329. metrics.graphite.server

Description

The hostname or IP address of the Graphite server.

Valid values

metrics.graphite.server, a socket address. If missing port or hostname it is acquired from dbms.default_listen_address

Default value

:2003

Table 330. metrics.jmx.enabled

Description

Set to true to enable the JMX metrics endpoint.

Valid values

metrics.jmx.enabled, a boolean

Default value

true

Table 331. metrics.jvm.buffers.enabled

Description

Enable reporting metrics about the buffer pools. Deprecated - use metrics.filter instead.

Valid values

metrics.jvm.buffers.enabled, a boolean

Default value

false

Deprecated

The metrics.jvm.buffers.enabled configuration setting has been deprecated.

Table 332. metrics.jvm.file.descriptors.enabled

Description

Enable reporting metrics about the number of open file descriptors. Deprecated - use metrics.filter instead.

Valid values

metrics.jvm.file.descriptors.enabled, a boolean

Default value

false

Deprecated

The metrics.jvm.file.descriptors.enabled configuration setting has been deprecated.

Table 333. metrics.jvm.gc.enabled

Description

Enable reporting metrics about the duration of garbage collections. Deprecated - use metrics.filter instead.

Valid values

metrics.jvm.gc.enabled, a boolean

Default value

false

Deprecated

The metrics.jvm.gc.enabled configuration setting has been deprecated.

Table 334. metrics.jvm.heap.enabled

Description

Enable reporting metrics about the heap memory usage. Deprecated - use metrics.filter instead.

Valid values

metrics.jvm.heap.enabled, a boolean

Default value

false

Deprecated

The metrics.jvm.heap.enabled configuration setting has been deprecated.

Table 335. metrics.jvm.memory.enabled

Description

Enable reporting metrics about the memory usage. Deprecated - use metrics.filter instead.

Valid values

metrics.jvm.memory.enabled, a boolean

Default value

false

Deprecated

The metrics.jvm.memory.enabled configuration setting has been deprecated.

Table 336. metrics.jvm.pause_time.enabled

Description

Enable reporting metrics about the VM pause time. Deprecated - use metrics.filter instead.

Valid values

metrics.jvm.pause_time.enabled, a boolean

Default value

false

Deprecated

The metrics.jvm.pause_time.enabled configuration setting has been deprecated.

Table 337. metrics.jvm.threads.enabled

Description

Enable reporting metrics about the current number of threads running. Deprecated - use metrics.filter instead.

Valid values

metrics.jvm.threads.enabled, a boolean

Default value

false

Deprecated

The metrics.jvm.threads.enabled configuration setting has been deprecated.

Table 338. metrics.namespaces.enabled

Description

Enable metrics namespaces that separates the global and database specific metrics. If enabled all database specific metrics will have field names starting with <metrics_prefix>.database.<database_name> and all global metrics will start with <metrics_prefix>.dbms. For example neo4j.page_cache.hits will become neo4j.dbms.page_cache.hits and neo4j.system.log.rotation_events will become neo4j.database.system.log.rotation_events.

Valid values

metrics.namespaces.enabled, a boolean

Default value

false

Table 339. metrics.neo4j.causal_clustering.enabled

Description

Enable reporting metrics about Causal Clustering mode. Deprecated - use metrics.filter instead.

Valid values

metrics.neo4j.causal_clustering.enabled, a boolean

Default value

false

Deprecated

The metrics.neo4j.causal_clustering.enabled configuration setting has been deprecated.

Table 340. metrics.neo4j.checkpointing.enabled

Description

Enable reporting metrics about Neo4j check pointing; when it occurs and how much time it takes to complete. Deprecated - use metrics.filter instead.

Valid values

metrics.neo4j.checkpointing.enabled, a boolean

Default value

false

Deprecated

The metrics.neo4j.checkpointing.enabled configuration setting has been deprecated.

Table 341. metrics.neo4j.counts.enabled

Description

Enable reporting metrics about approximately how many entities are in the database; nodes, relationships, properties, etc. Deprecated - use metrics.filter instead.

Valid values

metrics.neo4j.counts.enabled, a boolean

Default value

false

Deprecated

The metrics.neo4j.counts.enabled configuration setting has been deprecated.

Table 342. metrics.neo4j.data.counts.enabled

Description

Enable reporting metrics about number of entities in the database. Deprecated - use metrics.filter instead.

Valid values

metrics.neo4j.data.counts.enabled, a boolean

Default value

false

Deprecated

The metrics.neo4j.data.counts.enabled configuration setting has been deprecated.

Table 343. metrics.neo4j.database_operation_count.enabled

Description

Enable reporting metrics for Neo4j dbms operations; how many times databases have been created, started, stopped or dropped, and how many attempted operations have failed and recovered later. Deprecated - use metrics.filter instead.

Valid values

metrics.neo4j.database_operation_count.enabled, a boolean

Default value

false

Deprecated

The metrics.neo4j.database_operation_count.enabled configuration setting has been deprecated.

Table 344. metrics.neo4j.logs.enabled

Description

Enable reporting metrics about the Neo4j transaction logs. Deprecated - use metrics.filter instead.

Valid values

metrics.neo4j.logs.enabled, a boolean

Default value

false

Deprecated

The metrics.neo4j.logs.enabled configuration setting has been deprecated.

Table 345. metrics.neo4j.pagecache.enabled

Description

Enable reporting metrics about the Neo4j page cache; page faults, evictions, flushes, exceptions, etc. Deprecated - use metrics.filter instead.

Valid values

metrics.neo4j.pagecache.enabled, a boolean

Default value

false

Deprecated

The metrics.neo4j.pagecache.enabled configuration setting has been deprecated.

Table 346. metrics.neo4j.pools.enabled

Description

Enable reporting metrics about Neo4j memory pools. Deprecated - use metrics.filter instead.

Valid values

metrics.neo4j.pools.enabled, a boolean

Default value

false

Deprecated

The metrics.neo4j.pools.enabled configuration setting has been deprecated.

Table 347. metrics.neo4j.server.enabled

Description

Enable reporting metrics about Server threading info. Deprecated - use metrics.filter instead.

Valid values

metrics.neo4j.server.enabled, a boolean

Default value

false

Deprecated

The metrics.neo4j.server.enabled configuration setting has been deprecated.

Table 348. metrics.neo4j.size.enabled

Description

Enable reporting metrics about the store size of each database. Deprecated - use metrics.filter instead.

Valid values

metrics.neo4j.size.enabled, a boolean

Default value

false

Deprecated

The metrics.neo4j.size.enabled configuration setting has been deprecated.

Table 349. metrics.neo4j.tx.enabled

Description

Enable reporting metrics about transactions; number of transactions started, committed, etc. Deprecated - use metrics.filter instead.

Valid values

metrics.neo4j.tx.enabled, a boolean

Default value

false

Deprecated

The metrics.neo4j.tx.enabled configuration setting has been deprecated.

Table 350. metrics.prefix

Description

A common prefix for the reported metrics field names.

Valid values

metrics.prefix, a string

Default value

neo4j

Table 351. metrics.prometheus.enabled

Description

Set to true to enable the Prometheus endpoint.

Valid values

metrics.prometheus.enabled, a boolean

Default value

false

Table 352. metrics.prometheus.endpoint

Description

The hostname and port to use as Prometheus endpoint.

Valid values

metrics.prometheus.endpoint, a socket address. If missing port or hostname it is acquired from dbms.default_listen_address

Default value

localhost:2004