Docker-specific configuration settings

The Neo4j configuration settings can be passed to a Docker container using the following naming scheme:

  • Prefix with NEO4J_.

  • Underscores convert to double underscores: _ is written as __.

  • Periods convert to underscores: . is written as _.

For example, browser.post_connect_cmd converts to NEO4J_browser_post__connect__cmd, or in other words, s/\./_/g and s/_/__/g.

Neo4j on Docker supports Neo4j’s native SSL framework for setting up secure Bolt and HTTPS communications. The SSL policies are configured by assigning values to parameters of the following format:

dbms.ssl.policy.<scope>.<setting-suffix>

  • scope is the name of the communication channel, such as bolt or https.

  • setting-suffix can be enabled, base_directory, private_key, and public_certificate.
    For details, see SSL configuration.

Each policy needs to be explicitly enabled by setting dbms.ssl.policy.<scope>.enabled=true.

To convert SSL-related configuration settings into Docker format, follow the same rules as above:

  • dbms.ssl.policy.https.enabledNEO4J_dbms_ssl_policy_https_enabled

  • dbms.ssl.policy.https.base_directoryNEO4J_dbms_ssl_policy_https_base__directory

  • dbms.ssl.policy.https.private_keyNEO4J_dbms_ssl_policy_https_private__key

  • dbms.ssl.policy.https.public_certificateNEO4J_dbms_ssl_policy_https_public__certificate

  • dbms.ssl.policy.bolt.enabledNEO4J_dbms_ssl_policy_bolt_enabled

  • dbms.ssl.policy.bolt.base_directoryNEO4J_dbms_ssl_policy_bolt_base__directory

  • dbms.ssl.policy.bolt.private_keyNEO4J_dbms_ssl_policy_bolt_private__key

  • dbms.ssl.policy.bolt.public_certificateNEO4J_dbms_ssl_policy_bolt_public__certificate

Converting Neo4j settings to Docker environment format

The following table is a reference of the Neo4j configuration settings converted to the Docker-supported format.

For more information on the configuration descriptions, valid values, and default values, see Configuration settings.

Neo4j format Docker format

browser.allow_outgoing_connections

NEO4J_browser_allow__outgoing__connections

browser.credential_timeout

NEO4J_browser_credential__timeout

browser.post_connect_cmd

NEO4J_browser_post__connect__cmd

browser.remote_content_hostname_whitelist

NEO4J_browser_remote__content__hostname__whitelist

browser.retain_connection_credentials

NEO4J_browser_retain__connection__credentials

browser.retain_editor_history

NEO4J_browser_retain__editor__history

client.allow_telemetry

NEO4J_client_allow__telemetry

db.checkpoint

NEO4J_db_checkpoint

db.checkpoint.interval.time

NEO4J_db_checkpoint_interval_time

db.checkpoint.interval.tx

NEO4J_db_checkpoint_interval_tx

db.checkpoint.interval.volume

NEO4J_db_checkpoint_interval_volume

db.checkpoint.iops.limit

NEO4J_db_checkpoint_iops_limit

db.checkpoint.throughput.limit Introduced in 2025.07

NEO4J_db_checkpoint_throughput_limit

db.cluster.backup.pull_interval Introduced in 2026.06

NEO4J_db_cluster_backup_pull__interval

db.cluster.catchup.pull_interval

NEO4J_db_cluster_catchup_pull__interval

db.cluster.raft.apply.buffer.max_bytes

NEO4J_db_cluster_raft_apply_buffer_max__bytes

db.cluster.raft.apply.buffer.max_entries

NEO4J_db_cluster_raft_apply_buffer_max__entries

db.cluster.raft.in_queue.batch.max_bytes

NEO4J_db_cluster_raft_in__queue_batch_max__byte

db.cluster.raft.in_queue.max_bytes

NEO4J_db_cluster_raft_in__queue_max__bytes

db.cluster.raft.leader_transfer.priority_tag

NEO4J_db_cluster_raft_leader__transfer_priority__tag

db.cluster.raft.log.prune_strategy

NEO4J_db_cluster_raft_log_prune__strategy

db.cluster.raft.log_shipping.buffer.max_bytes

NEO4J_db_cluster_raft_log__shipping_buffer_max__bytes

db.cluster.raft.log_shipping.buffer.max_entries

NEO4J_db_cluster_raft_log__shipping_buffer_max__entries

db.cluster.raft.so_keepalive_enabled

NEO4J_db_cluster_raft_so__keepalive__enabled

db.filewatcher.enabled

NEO4J_db_filewatcher_enabled

db.format

NEO4J_db_format

db.import.csv.buffer_size

NEO4J_db_import_csv_buffer__size

db.import.csv.legacy_quote_escaping

NEO4J_db_import_csv_legacy__quote__escaping

db.index.fulltext.default_analyzer

NEO4J_db_index_fulltext_default__analyzer

db.index.fulltext.eventually_consistent

NEO4J_db_index_fulltext_eventually__consistent

db.index.fulltext.eventually_consistent_apply_parallelism

NEO4J_db_index_fulltext_eventually__consistent__apply__parallelism

db.index.fulltext.eventually_consistent_refresh_interval

NEO4J_db_index_fulltext_eventually__consistent__refresh__interval

db.index.fulltext.eventually_consistent_refresh_parallelism

NEO4J_db_index_fulltext_eventually__consistent__refresh__parallelism

db.index.fulltext.eventually_consistent_index_update_queue_max_length

NEO4J_db_index_fulltext_eventually__consistent__index__update__queue__max__length

db.index_sampling.background_enabled

NEO4J_db_index__sampling_background__enabled

db.index_sampling.sample_size_limit

NEO4J_db_index__sampling_sample__size__limit

db.index_sampling.update_percentage

NEO4J_db_index__sampling_update__percentage

db.lock.acquisition.timeout

NEO4J_db_lock_acquisition_timeout

db.logs.query.annotation_data_format

NEO4J_db_logs_query_annotation__data__format

db.logs.query.early_raw_logging_enabled

NEO4J_db_logs_query_early__raw__logging__enabled

db.logs.query.enabled

NEO4J_db_logs_query_enabled

db.logs.query.max_parameter_length

NEO4J_db_logs_query_max__parameter__length

db.logs.query.obfuscate_literals

NEO4J_db_logs_query_obfuscate__literals

db.logs.query.obfuscate_errors Introduced in 2026.01

NEO4J_db_logs_query_obfuscate__errors

db.logs.query.parameter_logging_enabled

NEO4J_db_logs_query_parameter__logging__enabled

db.logs.query.plan_description_enabled

NEO4J_db_logs_query_plan__description__enabled

db.logs.query.threshold

NEO4J_db_logs_query_threshold

db.logs.query.transaction.enabled

NEO4J_db_logs_query_transaction_enabled

db.logs.query.transaction.threshold

NEO4J_db_logs_query_transaction_threshold

db.memory.pagecache.warmup.enable

NEO4J_db_memory_pagecache_warmup_enable

db.memory.pagecache.warmup.order Introduced in 2026.03

NEO4J_db_memory_pagecache_warmup_order

db.memory.pagecache.warmup.preload

NEO4J_db_memory_pagecache_warmup_preload

db.memory.pagecache.warmup.preload.allowlist

NEO4J_db_memory_pagecache_warmup_preload_allowlist

db.memory.pagecache.warmup.profile.interval

NEO4J_db_memory_pagecache_warmup_profile_interval

db.memory.transaction.max

NEO4J_db_memory_transaction_max

db.memory.transaction.total.max

NEO4J_db_memory_transaction_total_max

db.query.default_language Introduced in 2025.06

NEO4J_db_query_default__language

db.recovery.fail_on_missing_files

NEO4J_db_recovery_fail__on__missing__files

db.relationship_grouping_threshold

NEO4J_db_relationship__grouping__threshold

db.shutdown_transaction_end_timeout

NEO4J_db_shutdown__transaction__end__timeout

db.store.files.preallocate

NEO4J_db_store_files_preallocate

db.temporal.timezone

NEO4J_db_temporal_timezone

db.track_query_cpu_time

NEO4J_db_track__query__cpu__time

db.transaction.bookmark_ready_timeout

NEO4J_db_transaction_bookmark__ready__timeout

db.transaction.concurrent.maximum

NEO4J_db_transaction_concurrent_maximum

db.transaction.monitor.check.interval

NEO4J_db_transaction_monitor_check_interval

db.transaction.sampling.percentage

NEO4J_db_transaction_sampling_percentage

db.transaction.timeout

NEO4J_db_transaction_timeout

db.transaction.tracing.level

NEO4J_db_transaction_tracing_level

db.tx_log.buffer.size

NEO4J_db_tx_log_buffer_size

db.tx_log.preallocate

NEO4J_db_tx__log_preallocate

db.tx_log.rotation.retention_policy

NEO4J_db_tx__log_rotation_retention__policy

db.tx_log.rotation.size

NEO4J_db_tx__log_rotation_size

dbms.cluster.endpoints

NEO4J_dbms_cluster_endpoints

dbms.cluster.discovery.resolver_type

NEO4J_dbms_cluster_discovery_resolver__type

dbms.cluster.minimum_initial_system_primaries_count

NEO4J_dbms_cluster_minimum__initial__system__primaries__count

dbms.cluster.network.client_inactivity_timeout

NEO4J_dbms_cluster_network_client__inactivity__timeout

dbms.cluster.network.connect_timeout

NEO4J_dbms_cluster_network_connect__timeout

dbms.cluster.network.handshake_timeout

NEO4J_dbms_cluster_network_handshake__timeout

dbms.cluster.network.max_chunk_size

NEO4J_dbms_cluster_network_max__chunk__size

dbms.cluster.network.supported_compression_algos

NEO4J_dbms_cluster_network_supported__compression__algos

dbms.cluster.raft.async_channel_acquisition_enabled Introduced in 2025.02

NEO4J_dbms_cluster_raft_async__channel__acquisition__enabled

dbms.cluster.raft.binding_timeout

NEO4J_dbms_cluster_raft_binding__timeout

dbms.cluster.raft.client.max_channels

NEO4J_dbms_cluster_raft_client_max__channels

dbms.cluster.raft.election_failure_detection_window

NEO4J_dbms_cluster_raft_election__failure__detection__window

dbms.cluster.raft.leader_failure_detection_window

NEO4J_dbms_cluster_raft_leader__failure__detection__window

dbms.cluster.raft.leader_transfer.balancing_strategy

NEO4J_dbms_cluster_raft_leader__transfer_balancing__strategy

dbms.cluster.raft.log.pruning_frequency

NEO4J_dbms_cluster_raft_log_pruning__frequency

dbms.cluster.raft.log.reader_pool_size

NEO4J_dbms_cluster_raft_log_reader__pool__size

dbms.cluster.raft.log.rotation_size

NEO4J_dbms_cluster_raft_log_rotation__size

dbms.cluster.raft.membership.join_max_lag

NEO4J_dbms_cluster_raft_membership_join__max__lag

dbms.cluster.raft.membership.join_timeout

NEO4J_dbms_cluster_raft_membership_join__timeout

dbms.cluster.store_copy.max_retry_time_per_request

NEO4J_dbms_cluster_store__copy_max__retry__time__per__request

dbms.cypher.forbid_exhaustive_shortestpath

NEO4J_dbms_cypher_forbid__exhaustive__shortestpath

dbms.cypher.forbid_shortestpath_common_nodes

NEO4J_dbms_cypher_forbid__shortestpath__common__nodes

dbms.cypher.hints_error

NEO4J_dbms_cypher_hints__error

dbms.cypher.infer_schema_parts

NEO4J_dbms_cypher_infer__schema__parts

dbms.cypher.lenient_create_relationship

NEO4J_dbms_cypher_lenient__create__relationship

dbms.cypher.min_replan_interval

NEO4J_dbms_cypher_min__replan__interval

dbms.cypher.planner

NEO4J_dbms_cypher_planner

dbms.cypher.render_plan_description

NEO4J_dbms_cypher_render__plan__description

dbms.cypher.statistics_divergence_threshold

NEO4J_dbms_cypher_statistics__divergence__threshold

dbms.cypher.transactions.default_subquery_batch_strategy Introduced in 2026.05

NEO4J_dbms_cypher_transactions_default__subquery__batch__strategy

dbms.cypher.transactions.default_subquery_retry_timeout Introduced in 2025.03

NEO4J_dbms_cypher_transactions_default__subquery__retry__timeout

dbms.databases.seed_from_uri_providers

NEO4J_dbms_databases_seed__from__uri__providers

dbms.db.timezone

NEO4J_dbms_db_timezone

dbms.fleet_manager.enabled Introduced in 2025.11

NEO4J_dbms_fleet__manager_enabled

dbms.integrations.cloud_storage.azb.blob_endpoint_suffix Introduced in 2025.03

NEO4J_dbms_integrations_cloud__storage_azb_blob__endpoint__suffix

dbms.integrations.cloud_storage.azb.authority_endpoint Introduced in 2025.03

NEO4J_dbms_integrations_cloud__storage_azb_authority__endpoint

dbms.integrations.cloud_storage.gs.project_id Introduced in 2025.03

NEO4J_dbms_integrations_cloud__storage_gs_project__id

dbms.integrations.cloud_storage.s3.target_throughput_gbps Introduced in 2025.03

NEO4J_dbms_integrations_cloud__storage_s3_target__throughput__gbps

dbms.kubernetes.address

NEO4J_dbms_kubernetes_address

dbms.kubernetes.ca_crt

NEO4J_dbms_kubernetes_ca__crt

dbms.kubernetes.cluster_domain

NEO4J_dbms_kubernetes_cluster__domain

dbms.kubernetes.discovery.service_port_name

NEO4J_dbms_kubernetes_discovery_service__port__name

dbms.kubernetes.label_selector

NEO4J_dbms_kubernetes_label__selector

dbms.kubernetes.namespace

NEO4J_dbms_kubernetes_namespace

dbms.kubernetes.token

NEO4J_dbms_kubernetes_token

dbms.logs.http.enabled

NEO4J_dbms_logs_http_enabled

db.lock.acquisition.timeout

NEO4J_dbms_lock_acquisition_timeout

dbms.logs.http.enabled

NEO4J_dbms_logs_http_enabled

dbms.max_databases

NEO4J_dbms_max__databases

dbms.memory.tracking.enable

NEO4J_dbms_memory_tracking_enable

dbms.memory.transaction.total.max

NEO4J_dbms_memory_transaction_total_max

dbms.netty.ssl.provider

NEO4J_dbms_netty_ssl_provider

dbms.routing.client_side.enforce_for_domains

NEO4J_dbms_routing_client__side_enforce__for__domains

dbms.routing.default_router

NEO4J_dbms_routing_default__router

dbms.routing.driver.connection.connect_timeout

NEO4J_dbms_routing_driver_connection_connect__timeout

dbms.routing.driver.connection.max_lifetime

NEO4J_dbms_routing_driver_connection_max__lifetime

dbms.routing.driver.connection.pool.acquisition_timeout

NEO4J_dbms_routing_driver_connection_pool_acquisition__timeout

dbms.routing.driver.connection.pool.idle_test

NEO4J_dbms_routing_driver_connection_pool_idle__test

dbms.routing.driver.connection.pool.max_size

NEO4J_dbms_routing_driver_connection_pool_max__size

dbms.routing.driver.logging.level

NEO4J_dbms_routing_driver_logging_level

dbms.routing.enabled

NEO4J_dbms_routing_enabled

dbms.routing.load_balancing.plugin

NEO4J_dbms_routing_load__balancing_plugin

dbms.routing.load_balancing.shuffle_enabled

NEO4J_dbms_routing_load__balancing_shuffle__enabled

dbms.routing.reads_on_primaries_enabled

NEO4J_dbms_routing_reads__on__primaries__enabled

dbms.routing.reads_on_writers_enabled

NEO4J_dbms_routing_reads__on__writers__enabled

dbms.routing_ttl

NEO4J_dbms_routing__ttl

dbms.security.abac.authorization_providers

NEO4J_dbms_security_abac_authorization__providers

dbms.security.allow_csv_import_from_file_urls

NEO4J_dbms_security_allow__csv__import__from__file__urls

dbms.security.allow_oidc_credential_forwarding_enabled Introduced in 2025.10

NEO4J_dbms_security_allow__oidc__credential__forwarding__enabled

dbms.security.auth_cache_max_capacity

NEO4J_dbms_security_auth__cache__max__capacity

dbms.security.auth_cache_ttl

NEO4J_dbms_security_auth__cache__ttl

dbms.security.auth_cache_use_ttl

NEO4J_dbms_security_auth__cache__use__ttl

dbms.security.auth_enabled

NEO4J_dbms_security_auth__enabled

dbms.security.auth_lock_time

NEO4J_dbms_security_auth__lock__time

dbms.security.auth_max_failed_attempts

NEO4J_dbms_security_auth__max__failed__attempts

dbms.security.auth_minimum_password_length

NEO4J_dbms_security_auth__minimum__password__length

dbms.security.authentication_providers

NEO4J_dbms_security_authentication__providers

dbms.security.authorization_providers

NEO4J_dbms_security_authorization__providers

dbms.security.cluster_status_auth_enabled

NEO4J_dbms_security_cluster__status__auth__enabled

dbms.security.http_access_control_allow_origin

NEO4J_dbms_security_http__access__control__allow_origin

dbms.security.http_auth_allowlist

NEO4J_dbms_security_http__auth__allowlist

dbms.security.http_static_content_security_policy_header

NEO4J_dbms_security_http__static__content__security__policy__header

dbms.security.http_strict_transport_security

NEO4J_dbms_security_http__strict__transport__security

dbms.security.key.name

NEO4J_dbms_security_key_name

dbms.security.keystore.password

NEO4J_dbms_security_keystore_password

dbms.security.keystore.path

NEO4J_dbms_security_keystore_path

dbms.security.ldap.authentication.attribute

NEO4J_dbms_security_ldap_authentication_attribute

dbms.security.ldap.authentication.cache_enabled

NEO4J_dbms_security_ldap_authentication_cache__enabled

dbms.security.ldap.authentication.mechanism

NEO4J_dbms_security_ldap_authentication_mechanism

dbms.security.ldap.authentication.search_for_attribute

NEO4J_dbms_security_ldap_authentication_search__for__attribute

dbms.security.ldap.authentication.user_dn_template

NEO4J_dbms_security_ldap_authentication_user__dn__template

dbms.security.ldap.authorization.access_permitted_group

NEO4J_dbms_security_ldap_authorization_access__permitted__group

dbms.security.ldap.authorization.group_membership_attributes

NEO4J_dbms_security_ldap_authorization_group__membership__attributes

dbms.security.ldap.authorization.group_to_role_mapping

NEO4J_dbms_security_ldap_authorization_group__to__role__mapping

dbms.security.ldap.authorization.nested_groups_enabled

NEO4J_dbms_security_ldap_authorization_nested__groups__enabled

dbms.security.ldap.authorization.nested_groups_search_filter

NEO4J_dbms_security_ldap_authorization_nested__groups__search__filter

dbms.security.ldap.authorization.system_password

NEO4J_dbms_security_ldap_authorization_system__password

dbms.security.ldap.authorization.system_username

NEO4J_dbms_security_ldap_authorization_system__username

dbms.security.ldap.authorization.use_system_account

NEO4J_dbms_security_ldap_authorization_use__system__account

dbms.security.ldap.authorization.user_search_base

NEO4J_dbms_security_ldap_authorization_user__search__base

dbms.security.ldap.authorization.user_search_filter

NEO4J_dbms_security_ldap_authorization_user__search__filter

dbms.security.ldap.connection_timeout

NEO4J_dbms_security_ldap_connection__timeout

dbms.security.ldap.host

NEO4J_dbms_security_ldap_host

dbms.security.ldap.read_timeout

NEO4J_dbms_security_ldap_read__timeout

dbms.security.ldap.referral

NEO4J_dbms_security_ldap_referral

dbms.security.ldap.use_starttls

NEO4J_dbms_security_ldap_use__starttls

dbms.security.log_successful_authentication

NEO4J_dbms_security_log__successful__authentication

dbms.security.logs.ldap.groups_at_debug_level_enabled

NEO4J_dbms_security_logs_ldap_groups__at__debug__level__enabled

dbms.security.logs.oidc.jwt_claims_at_debug_level_enabled

NEO4J_dbms_security_logs_oidc_jwt__claims__at__debug__level__enabled

dbms.security.oidc.<provider>.audience

NEO4J_dbms_security_oidc_<provider>_audience

dbms.security.oidc.<provider>.auth_endpoint

NEO4J_dbms_security_oidc_<provider>_auth__endpoint

dbms.security.oidc.<provider>.auth_flow

NEO4J_dbms_security_oidc_<provider>_auth__flow

dbms.security.oidc.<provider>.auth_params

NEO4J_dbms_security_oidc_<provider>_auth__params

dbms.security.oidc.<provider>.authorization.group_to_role_mapping

NEO4J_dbms_security_oidc_<provider>_authorization_group__to__role__mapping

dbms.security.oidc.<provider>.claims.groups

NEO4J_dbms_security_oidc_<provider>_claims_groups

dbms.security.oidc.<provider>.claims.username

NEO4J_dbms_security_oidc_<provider>_claims_username

dbms.security.oidc.<provider>.client_id

NEO4J_dbms_security_oidc_<provider>_client__id

dbms.security.oidc.<provider>.config

NEO4J_dbms_security_oidc_<provider>_config

dbms.security.oidc.<provider>.display_name

NEO4J_dbms_security_oidc_<provider>_display__name

dbms.security.oidc.<provider>.get_groups_from_user_info

NEO4J_dbms_security_oidc_<provider>_get__groups__from__user__info

dbms.security.oidc.<provider>.get_username_from_user_info

NEO4J_dbms_security_oidc_<provider>_get__username__from__user__info

dbms.security.oidc.<provider>.issuer

NEO4J_dbms_security_oidc_<provider>_issuer

dbms.security.oidc.<provider>.jwks_uri

NEO4J_dbms_security_oidc_<provider>_jwks__uri

dbms.security.oidc.<provider>.params

NEO4J_dbms_security_oidc_<provider>_params

dbms.security.oidc.<provider>.token_endpoint

NEO4J_dbms_security_oidc_<provider>_token__endpoint

dbms.security.oidc.<provider>.token_params

NEO4J_dbms_security_oidc_<provider>_token__params

dbms.security.oidc.<provider>.user_info_uri

NEO4J_dbms_security_oidc_<provider>_user__info__uri

dbms.security.oidc.<provider>.well_known_discovery_uri

NEO4J_dbms_security_oidc_<provider>_well__known__discovery__uri

dbms.security.procedures.allowlist

NEO4J_dbms_security_procedures_allowlist

dbms.security.procedures.unrestricted

NEO4J_dbms_security_procedures_unrestricted

dbms.security.require_local_user

NEO4J_dbms_security_require__local__user

dbms.security.tls_reload_enabled Introduced in 2025.03

NEO4J_dbms_security_tls__reload__enabled

dbms.usage_report.enabled

NEO4J_dbms_usage__report_enabled

initial.dbms.automatically_enable_free_servers

NEO4J_initial_dbms_automatically__enable__free__servers

initial.dbms.default_database

NEO4J_initial_dbms_default__database

initial.dbms.default_primaries_count

NEO4J_initial_dbms_default__primaries__count

initial.dbms.default_property_shard_replica_count Introduced in 2025.12

NEO4J_initial_dbms_default__property__shard__replica__count

initial.dbms.default_secondaries_count

NEO4J_initial_dbms_default__secondaries__count

initial.server.allowed_databases

NEO4J_initial_server_allowed__databases

initial.server.denied_databases

NEO4J_initial_server_denied__databases

initial.server.mode_constraint

NEO4J_initial_server_mode__constraint

initial.server.tags

NEO4J_initial_server_tags

server.backup.advertised_address Introduced in 2025.05

NEO4J_server_backup_advertised__address

server.backup.enabled

NEO4J_server_backup_enabled

server.backup.exec_connector.command

NEO4J_server_backup_exec__connector_command

server.backup.exec_connector.scheme

NEO4J_server_backup_exec__connector_scheme

server.backup.listen_address

NEO4J_server_backup_listen__address

server.backup.store_copy_max_retry_time_per_request

NEO4J_server_backup_store__copy__max__retry__time__per__request

server.bolt.additional_listen_addresses

NEO4J_server_bolt_additional__listen__addresses

server.bolt.advertised_address

NEO4J_server_bolt_advertised__address

server.bolt.connection_keep_alive

NEO4J_server_bolt_connection__keep__alive

server.bolt.connection_keep_alive_for_requests

NEO4J_server_bolt_connection__keep__alive__for__requests

server.bolt.connection_keep_alive_probes

NEO4J_server_bolt_connection__keep__alive__probes

server.bolt.connection_keep_alive_streaming_scheduling_interval

NEO4J_server_bolt_connection__keep__alive__streaming__scheduling__interval

server.bolt.enabled

NEO4J_server_bolt_enabled

server.bolt.enable_network_error_accounting

NEO4J_server_bolt_enable__network__error__accounting

server.bolt.listen_address

NEO4J_server_bolt_listen__address

server.bolt.network_abort_clear_window_duration

NEO4J_server_bolt_network__abort__clear__window__duration

server.bolt.network_abort_warn_threshold

NEO4J_server_bolt_network__abort__warn__threshold

server.bolt.network_abort_warn_window_duration

NEO4J_server_bolt_network__abort__warn__window__duration

server.bolt.ocsp_stapling_enabled

NEO4J_server_bolt_ocsp__stapling__enabled

server.bolt.telemetry.enabled

NEO4J_server_bolt_telemetry_enabled

server.bolt.thread_pool_keep_alive

NEO4J_server_bolt_thread__pool__keep__alive

server.bolt.thread_pool_max_size

NEO4J_server_bolt_thread__pool__max__size

server.bolt.thread_pool_min_size

NEO4J_server_bolt_thread__pool__min__size

server.bolt.thread_starvation_clear_window_duration

NEO4J_server_bolt_thread__starvation__clear__window__duration

server.bolt.thread_starvation_warn_threshold

NEO4J_server_bolt_thread__starvation__warn__threshold

server.bolt.thread_starvation_warn_window_duration

NEO4J_server_bolt_thread__starvation__warn__window__duration

server.bolt.tls_level

NEO4J_server_bolt_tls__level

server.bolt.traffic_accounting_check_period

NEO4J_server_bolt_traffic__accounting__check__period

server.bolt.traffic_accounting_clear_duration

NEO4J_server_bolt_traffic__accounting__clear__duration

server.bolt.traffic_accounting_incoming_threshold_mbps

NEO4J_server_bolt_traffic__accounting__incoming__threshold__mbps

server.bolt.traffic_accounting_outgoing_threshold_mbps

NEO4J_server_bolt_traffic__accounting__outgoing__threshold__mbps

server.bolt.unix_socket_auth Introduced in 2025.08

NEO4J_server_bolt_unix__socket__auth

server.bolt.unix_socket_delete Introduced in 2025.08

NEO4J_server_bolt_unix__socket__delete

server.bolt.unix_socket_enabled Introduced in 2025.08

NEO4J_server_bolt_unix__socket__enabled

server.bolt.unix_socket_path Introduced in 2025.08

NEO4J_server_bolt_unix__socket__path

server.bolt.unix_socket_permission_mask Introduced in 2025.08

NEO4J_server_bolt_unix__socket__permission__mask

server.bolt.unix_socket_thread_pool_keep_alive Introduced in 2025.08

NEO4J_server_bolt_unix__socket__thread__pool__keep__alive

server.bolt.unix_socket_thread_pool_max_size Introduced in 2025.08

NEO4J_server_bolt_unix__socket__thread__pool__max__size

server.bolt.unix_socket_thread_pool_min_size Introduced in 2025.08

NEO4J_server_bolt_unix__socket__thread__pool__min__size

server.bolt.unix_socket_use_dedicated_thread_pool Introduced in 2025.08

NEO4J_server_bolt_unix__socket__use__dedicated__thread__pool

server.cluster.advertised_address

NEO4J_server_cluster_advertised__address

server.cluster.catchup.connect_randomly_to_server_tags

NEO4J_server_cluster_catchup_connect__randomly__to__server__tags

server.cluster.catchup.upstream_strategy

NEO4J_server_cluster_catchup_upstream__strategy

server.cluster.catchup.user_defined_upstream_strategy

NEO4J_server_cluster_catchup_user__defined__upstream__strategy

server.cluster.listen_address

NEO4J_server_cluster_listen__address

server.cluster.network.native_transport_enabled

NEO4J_server_cluster_network_native__transport__enabled

server.cluster.raft.advertised_address

NEO4J_server_cluster_raft_advertised__address

server.cluster.raft.listen_address

NEO4J_server_cluster_raft_listen__address

server.cluster.system_database_mode

NEO4J_server_cluster_system__database__mode

server.config.strict_validation.enabled

NEO4J_server_config_strict__validation_enabled

server.cypher.parallel.worker_limit

NEO4J_server_cypher_parallel_worker__limit

server.databases.default_to_read_only

NEO4J_server_databases_default__to__read__only

server.databases.read_only

NEO4J_server_databases_read__only

server.databases.writable

NEO4J_server_databases_writable

server.db.query_cache_size

NEO4J_server_db_query__cache__size

server.default_advertised_address

NEO4J_server_default__advertised__address

server.default_listen_address

NEO4J_server_default__listen__address

server.directories.cluster_state

NEO4J_server_directories_cluster__state

server.directories.configuration Introduced in 2025.01

NEO4J_server_directories_configuration

server.directories.data

NEO4J_server_directories_data

server.directories.dumps.root

NEO4J_server_directories_dumps_root

server.directories.import

NEO4J_server_directories_import

server.directories.lib

NEO4J_server_directories_lib

server.directories.licenses

NEO4J_server_directories_licenses

server.directories.logs

NEO4J_server_directories_logs

server.directories.metrics

NEO4J_server_directories_metrics

server.directories.neo4j_home

NEO4J_server_directories_neo4j__home

server.directories.plugins

NEO4J_server_directories_plugins

server.directories.run

NEO4J_server_directories_run

server.directories.seeds Introduced in 2026.04

NEO4J_server_directories_seeds

server.directories.script.root

NEO4J_server_directories_script_root

server.directories.transaction.logs.root

NEO4J_server_directories_transaction_logs_root

server.dynamic.setting.allowlist

NEO4J_server_dynamic_setting_allowlist

server.fleet_discovery.broadcast_interval Introduced in 2026.05

NEO4J_server_fleet__discovery_broadcast__interval

server.fleet_discovery.broadcast_interval_jitter Introduced in 2026.05

NEO4J_server_fleet__discovery_broadcast__interval__jitter

server.fleet_discovery.enabled Introduced in 2026.05

NEO4J_server_fleet__discovery_enabled

server.fleet_discovery.port Introduced in 2026.05

NEO4J_server_fleet__discovery_port

server.http.advertised_address

NEO4J_server_http_advertised__address

server.http.enabled

NEO4J_server_http_enabled

server.http.listen_address

NEO4J_server_http_listen__address

server.http.x_forward.allow_hosts Introduced in 2026.03

NEO4J_server_http_x__forward_allow__hosts

server.http.x_forward.allow_proxies Introduced in 2026.03

NEO4J_server_http_x__forward_allow__proxies

server.http.x_forward.enabled Introduced in 2026.03

NEO4J_server_http_x__forward_enabled

server.http.x_forward.private_ips_enabled Introduced in 2026.03

NEO4J_server_http_x__forward_private__ips__enabled

server.http_enabled_modules

NEO4J_server_http__enabled__modules

server.http_enabled_transports

NEO4J_server_http__enabled__transports

server.http.transaction_idle_timeout

NEO4J_server_http_transaction__idle__timeout

server.https.advertised_address

NEO4J_server_https_advertised__address

server.https.enabled

NEO4J_server_https_enabled

server.https.listen_address

NEO4J_server_https_listen__address

server.jvm.additional

NEO4J_server_jvm_additional

server.logs.config

NEO4J_server_logs_config

server.logs.debug.enabled

NEO4J_server_logs_debug_enabled

server.logs.gc.enabled

NEO4J_server_logs_gc_enabled

server.logs.gc.options

NEO4J_server_logs_gc_options

server.logs.gc.rotation.keep_number

NEO4J_server_logs_gc_rotation_keep__number

server.logs.gc.rotation.size

NEO4J_server_logs_gc_rotation_size

server.logs.user.config

NEO4J_server_logs_user_config

server.memory.heap.initial_size

NEO4J_server_memory_heap_initial__size

server.memory.heap.max_size

NEO4J_server_memory_heap_max__size

server.memory.pagecache.async Introduced in 2026.04

NEO4J_server_memory_pagecache_async

server.memory.pagecache.directio

NEO4J_server_memory_pagecache_directio

server.memory.pagecache.flush.buffer.enabled

NEO4J_server_memory_pagecache_flush_buffer_enabled

server.memory.pagecache.flush.buffer.size_in_pages

NEO4J_server_memory_pagecache_flush_buffer_size__in__pages

server.memory.pagecache.scan.prefetchers

NEO4J_server_memory_pagecache_scan_prefetchers

server.memory.pagecache.size

NEO4J_server_memory_pagecache_size

server.memory.query_cache.per_db_cache_num_entries

NEO4J_server_memory_query__cache_per__db__cache__num__entries

server.memory.query_cache.shared_cache_num_entries

NEO4J_server_memory_query__cache_shared__cache__num__entries

server.memory.query_cache.sharing_enabled

NEO4J_server_memory_query__cache_sharing__enabled

server.queryapi.transaction_idle_timeout

NEO4J_server_queryapi_transaction__idle__timeout

server.metrics.csv.enabled

NEO4J_server_metrics_csv_enabled

server.metrics.csv.interval

NEO4J_server_metrics_csv_interval

server.metrics.csv.rotation.compression

NEO4J_server_metrics_csv_rotation_compression

server.metrics.csv.rotation.keep_number

NEO4J_server_metrics_csv_rotation_keep__number

server.metrics.csv.rotation.size

NEO4J_server_metrics_csv_rotation_size

server.metrics.deny_filter Introduced in 2025.10

NEO4J_server_metrics_deny__filter

server.metrics.enabled

NEO4J_server_metrics_enabled

server.metrics.filter

NEO4J_server_metrics_filter

server.metrics.graphite.enabled

NEO4J_server_metrics_graphite_enabled

server.metrics.graphite.interval

NEO4J_server_metrics_graphite_interval

server.metrics.graphite.server

NEO4J_server_metrics_graphite_server

server.metrics.jmx.enabled

NEO4J_server_metrics_jmx_enabled

server.metrics.prefix

NEO4J_server_metrics_prefix

server.metrics.prometheus.enabled

NEO4J_server_metrics_prometheus_enabled

server.metrics.prometheus.endpoint

NEO4J_server_metrics_prometheus_endpoint

server.panic.shutdown_on_panic

NEO4J_server_panic_shutdown__on__panic

server.routing.advertised_address

NEO4J_server_routing_advertised__address

server.routing.listen_address

NEO4J_server_routing_listen__address

server.threads.worker_count

NEO4J_server_threads_worker__count

server.unmanaged_extension_classes

NEO4J_server_unmanaged__extension__classes

server.windows_service_name

NEO4J_server_windows__service__name

Glossary

allocator

A component in the cluster that allocates databases to servers according to the topology constraints specified and an allocation strategy.

asynchronous replication

Asynchronous replication is used by secondary copies to poll for new transactions, which means they cannot be guaranteed to have received the most recent transactions. This enables efficient scale-out of read-performance.

Aura instance

A fully-managed DBMS represented by a single instance ID, that is running in the Neo4j Aura cloud.

auto-commit transaction

An automatically committed transaction that contains a single query.

Bolt protocol

Bolt is a protocol used for interaction between Neo4j instances and drivers.

bookmark

A marker the client can request from the cluster to ensure that it is able to read its own writes so that the application’s state is consistent and only databases that have a copy of the bookmark are permitted to respond.

category (Bloom)

A category is based on a node label and is defined in a Perspective as a way of visually distinguishing nodes with the same label(s).

causal consistency

All servers in a cluster agree on the order in which transactions take place. The position of a server on the causal chain can be guaranteed using a bookmark.

cluster

A Neo4j DBMS that spans multiple servers working together to increase fault tolerance and/or read scalability. Databases on a cluster may be configured to replicate across servers in the cluster thus achieving read scalability or high availability.

client application

Software that interacts with a Neo4j server.

commit

A commit is the successful completion of a transaction, which ensures durability of any changes made. For more details, visit Operations Manual → Transaction management.

composite database

Composite databases are the means to access partitioned graph data with a single Cypher query.

constraint

Constraints are sets of data modeling rules that ensure the data is consistent and reliable.

Cypher®

Neo4j’s graph query language.

data model

A data model defines how information is organized in a database. A good data model will make querying and understanding your data easier. In Neo4j, the data models have a graph structure.

database

A database is a container used by the DBMS to manage and store graph data. The physical structure of data is controlled by the database.

database vs graph

Databases are the physical containers of graph data. Graphs are the logical structure of data in Neo4j.

Database Management System

Database Management System, or DBMS, capable of managing multiple databases. A DBMS may run on a single server, or span several servers configured as a cluster.

database schema

The prescribed property existence and datatypes for nodes and relationships.

deallocate

An act of removing a database from a server or a server from a cluster without loss of data or reduced fault tolerance.

degree (of a node)

The number of relationships of a specific node; loops are counted twice.

disaster recovery

A manual intervention to restore availability of a cluster, or databases within a cluster.

driver

A software library that provides access to Neo4j from a particular programming language.

election

In the event that the Raft leader becomes unresponsive, followers automatically trigger an election and vote for a new leader.

entity

A node or a relationship.

expression (Cypher)

A component of a Cypher query which produces values. It may be used in projections, as a predicate, or when setting properties on graph elements.

fabric

Fabric is the architectural design of a unified system that provides a single access point to local or distributed graph data.

fault tolerance

A guarantee that a cluster can maintain a database’s persistence and availability in the event of one or more servers failing.

follower

A primary copy of a database acting as a follower, receives and acknowledges synchronous writes from the leader.

Generative AI (GenAI)

A type of artificial intelligence (AI) system that generates text, images, or other media in response to prompts.

graph

A logical representation of a set of nodes where some pairs are connected by relationships.

index

Data structure that improves read performance of a database.

knowledge graph

A specific type of graph that has an organizing principle so that a user (or a computer system) can reason about the underlying data. The organizing principle provides an additional layer of structure that adds context to support knowledge discovery.

label

Marks a node as a member of a named and indexed subset. A node may be assigned zero or more labels.

leader

A single primary copy of a database is designated as the leader. It receives all write transactions from clients and replicates writes synchronously to followers and asynchronously to secondary copies of the database.

main database

In terms of Neo4j Enterprise Studio, the database(s) containing the user’s data. Can exist in the same Neo4j deployment as the tool asset database.

motif

A description of a specific pattern within a graph.

node

A node represents an entity or discrete object in your graph data model. Nodes can be connected by relationships, hold data in properties, and are classified by labels.

operator

A symbol representing a mathematical or logical operation.

parameter

Named value provided when running a Cypher statement.

path

A sequence of nodes and the relationships connecting them, that does not contain duplicate relationships. Several paths can match a pattern.

pattern

A specific arrangement of nodes and relationships that can be matched in a graph. A pattern follows a motif.

perspective (Bloom)

A Perspective defines a certain business view or domain that can be found in the target Neo4j graph. A single Neo4j graph can be viewed through different Perspectives, each tailored for a different business purpose.

primary

A copy of the database that is able to process write transactions and is eligible to be elected as a leader. It participates in fault tolerant writes as it is part of the majority required to acknowledge and commit write transactions.

primary vs secondary

In a cluster, databases can operate in either primary or secondary mode. Primary databases are able to process write and read transactions, ensuring fault tolerance. Secondary databases are replicated asynchronously from primaries, and their main purpose is to provide read scaling within the cluster.

project (Aura)

An isolated environment in the unified Aura console that contains its own database instances, configurations, and resources. Preceded by tenant in the classic Aura console.

property

Properties are key-value pairs that are used for storing data on nodes and relationships.

query (Cypher)

A statement that retrieves or writes information to a database.

Raft group

A group of servers that are participating in hosting a particular database in primary mode.

Raft group member

A server that is participating in a Raft group. A server can be a member of one or more groups.

Raft log

A shared log between all Raft group members that is guaranteed to be consistently updated and viewed by those members. The log contains both database data and operational state of the Raft group.

Raft protocol

The networking mechanism that enables a database to replicate its data across multiple servers to give high availability for accessing the data and high durability to the data stored.

read scaling

Distributing query load by creating additional database copies hosted in secondary mode (read-only).

relationship

A relationship represents a connection between nodes in your graph data model. Relationships connect a source node to a target node, hold data in properties, and are classified by type.

secondary

An asynchronously replicated copy of the database that provides read scaling within the cluster.

seed

A seed is a database dump or a full backup used to create a database on a cluster. This is sometimes called seeding.

server

A physical machine, a virtual machine, or a container running an instance of Neo4j. Servers can be standalone or part of a cluster.

session

A causally linked sequence of transactions.

session consistency

An alternative name for Neo4j’s causal consistency.

standalone

A single server running Neo4j and not part of a cluster.

synchronous replication

Synchronous replication requires the leader primary to replicate a transaction and block the commit until a quorum of the follower primaries acknowledges that the transaction is successfully replicated. Once the transaction is replicated, the commit is allowed to proceed. This ensures data durability and consistency within the cluster.

system database

A database used by Neo4j to store system information.

tenant (Aura)

An isolated environment in the classic Aura console that contains its own database instances, configurations, and resources. Replaced by project in the unified Aura console.

tool asset database

In terms of Neo4j Enterprise Studio, the database where tools' assets are stored. This can be in the same Neo4j deployment as the main database(s) or in a separate deployment.

topology

A configuration that describes how the copies of a database should be spread across the servers in a cluster, see primary mode and secondary mode.

transaction

A transaction comprises a unit of work performed against a database. It is treated in a coherent and reliable way, independent of other transactions. Transactions comply with the ACID consistency model (atomic, consistent, isolated, and durable).