{
  "id": "cluster_settings",
  "title": "Cluster settings object",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/references/rest-api/objects/cluster_settings/",
  "summary": "An object for cluster resource management settings",
  "content": "\nCluster resources management policy\n\n| Name | Type/Value | Description |\n|------|------------|-------------|\n| acl_pubsub_default | `resetchannels`\u003cbr /\u003e `allchannels` | Default pub/sub ACL rule for all databases in the cluster:\u003cbr /\u003e•`resetchannels` blocks access to all channels (restrictive)\u003cbr /\u003e•`allchannels` allows access to all channels (permissive) |\n| auto_recovery | boolean (default: false) | Defines whether to use automatic recovery after shard failure |\n| automatic_node_offload | boolean (default: true) | Defines whether the cluster will automatically migrate shards from a node, in case the node is overbooked |\n| \u003cspan class=\"break-all\"\u003ebigstore_migrate_node_threshold\u003c/span\u003e | integer | Minimum free memory (excluding reserved memory) allowed on a node before automatic migration of shards from it to free more memory |\n| \u003cspan class=\"break-all\"\u003ebigstore_migrate_node_threshold_p\u003c/span\u003e | integer | Minimum free memory (excluding reserved memory) allowed on a node before automatic migration of shards from it to free more memory |\n| \u003cspan class=\"break-all\"\u003ebigstore_provision_node_threshold\u003c/span\u003e | integer | Minimum free memory (excluding reserved memory) allowed on a node before new shards can no longer be added to it |\n| \u003cspan class=\"break-all\"\u003ebigstore_provision_node_threshold_p\u003c/span\u003e | integer | Minimum free memory (excluding reserved memory) allowed on a node before new shards can no longer be added to it |\n| data_internode_encryption | boolean | Enable/deactivate encryption of the data plane internode communication |\n| db_conns_auditing | boolean | [Audit connections]() for new databases by default if set to true. |\n| \u003cspan class=\"break-all\"\u003edefault_concurrent_restore_actions\u003c/span\u003e | integer | Default number of restore actions allowed at the same time. Set to 0 to allow any number of simultaneous restore actions. |\n| default_fork_evict_ram | boolean | If true, the bdbs should evict data from RAM to ensure successful replication or persistence |\n| \u003cspan class=\"break-all\"\u003edefault_non_sharded_proxy_policy\u003c/span\u003e | `single`\u003cbr /\u003e\u003cbr /\u003e`all-master-shards`\u003cbr /\u003e\u003cbr /\u003e`all-nodes` | Default proxy_policy for newly created non-sharded databases' endpoints |\n| default_oss_sharding | boolean (default: false) | Default hashing policy to use for new databases. This field is for future use only and should not be changed. |\n| \u003cspan class=\"break-all\"\u003edefault_provisioned_redis_version\u003c/span\u003e | string | Default Redis version |\n| \u003cspan class=\"break-all\"\u003edefault_sharded_proxy_policy\u003c/span\u003e | `single`\u003cbr /\u003e\u003cbr /\u003e`all-master-shards`\u003cbr /\u003e\u003cbr /\u003e`all-nodes` | Default proxy_policy for newly created sharded databases' endpoints |\n| default_shards_placement | `dense`\u003cbr /\u003e`sparse` | Default shards_placement for a newly created databases |\n| \u003cspan class=\"break-all\"\u003edefault_recovery_wait_time\u003c/span\u003e | integer (default: -1) | The default time for new databases to wait for the persistence file to be available during automatic recovery. -1 means wait forever. |\n| \u003cspan class=\"break-all\"\u003edefault_tracking_table_max_keys_policy\u003c/span\u003e | integer (default: 1000000) | Defines the default value of the client-side caching invalidation table size for new databases. 0 makes the cache unlimited. |\n| diskless_repl | `yes`\u003cbr /\u003e`no` (default: yes) | If `yes`, enable default Redis diskless replication mechanism (deprecated; use `repl_diskless` instead) |\n| \u003cspan class=\"break-all\"\u003eendpoint_rebind_propagation_grace_time\u003c/span\u003e | integer | Time to wait between the addition and removal of a proxy |\n| \u003cspan class=\"break-all\"\u003eevict_node_use_free_memory\u003c/span\u003e | boolean | When evicting a node, use the free memory instead of the provisional memory to check if the shards from the old node fit on the new one |\n| \u003cspan class=\"break-all\"\u003eexpose_hostnames_for_all_suffixes\u003c/span\u003e | boolean (default: false) | If true, enables exposing hostnames for non-default DNS suffixes |\n| \u003cspan class=\"break-all\"\u003efailure_detection_sensitivity\u003c/span\u003e | `high`\u003cbr /\u003e`low` | Predefined thresholds and timeouts for failure detection (previously known as \u003cspan class=\"break-all\"\u003e`watchdog_profile`\u003c/span\u003e)\u003cbr /\u003e• `high` (previously `local-network`) – high failure detection sensitivity, lower thresholds, faster failure detection and failover\u003cbr /\u003e• `low` (previously `cloud`) – low failure detection sensitivity, higher tolerance for latency variance (also called network jitter) |\n| hide_user_data_from_log | boolean (default: false) | Set to `true` to enable the \u003cspan class=\"break-all\"\u003e`hide-user-data-from-log`\u003c/span\u003e Redis configuration setting, which avoids logging user data |\n| \u003cspan class=\"break-all\"\u003elogin_lockout_counter_reset_after\u003c/span\u003e | integer | Number of seconds that must elapse between failed sign in attempts before the lockout counter is reset to 0. |\n| login_lockout_duration | integer | Duration (in secs) of account lockout. If set to 0, the account lockout will persist until released by an admin. |\n| login_lockout_threshold | integer | Number of failed sign in attempts allowed before locking a user account |\n| \u003cspan class=\"break-all\"\u003emaster_healthcheck_api_auth\u003c/span\u003e | boolean (default: true) | Defines if authentication is required by the local `master_healthcheck` API |\n| max_redis_forks | integer (default: 0) | Maximum number of background processes forked from shards that can exist on the node at any given time. 0 means unlimited. |\n| max_saved_events_per_type | integer | Maximum saved events per event type |\n| max_slave_full_syncs | integer (default: 0) | Maximum number of simultaneous replica full syncs that can run at any given time. 0 means unlimited. |\n| max_simultaneous_backups | integer (default: 4) | Maximum number of backup processes allowed at the same time |\n| \u003cspan class=\"break-all\"\u003emetrics_exporter_expose_bdb_name\u003c/span\u003e | boolean (default: false) | If true, adds a label with the database name to relevant metrics |\n| \u003cspan class=\"break-all\"\u003eoss_cluster_api_preferred_endpoint_type\u003c/span\u003e | `ip`\u003cbr /\u003e`hostname` (default: ip) | Determines the default endpoint type in the OSS Cluster API for new endpoints |\n| \u003cspan class=\"break-all\"\u003eoss_cluster_api_preferred_ip_type\u003c/span\u003e | `internal`\u003cbr /\u003e`external` (default: internal) | Determines the default IP type in the OSS Cluster API for new endpoints |\n| parallel_shards_upgrade | integer | Maximum number of shards to upgrade in parallel |\n| \u003cspan class=\"break-all\"\u003epersistence_cleanup_grace_time\u003c/span\u003e | integer | Time in seconds before an unmodified file is considered to be stale and to be removed by persistence cleanup |\n| \u003cspan class=\"break-all\"\u003epersistence_cleanup_scan_interval\u003c/span\u003e | string | [CRON expression](https://en.wikipedia.org/wiki/Cron#CRON_expression) that defines the Redis cleanup schedule |\n| persistent_node_removal | boolean | When removing a node, wait for persistence files to be created for all migrated shards |\n| rack_aware | boolean | Cluster operates in a rack-aware mode |\n| \u003cspan class=\"break-all\"\u003eredis_migrate_node_threshold\u003c/span\u003e | integer | Minimum free memory (excluding reserved memory) allowed on a node before automatic migration of shards from it to free more memory |\n| \u003cspan class=\"break-all\"\u003eredis_migrate_node_threshold_p\u003c/span\u003e | integer | Minimum free memory (excluding reserved memory) allowed on a node before automatic migration of shards from it to free more memory |\n| \u003cspan class=\"break-all\"\u003eredis_provision_node_threshold\u003c/span\u003e | integer | Minimum free memory (excluding reserved memory) allowed on a node before new shards can no longer be added to it |\n| \u003cspan class=\"break-all\"\u003eredis_provision_node_threshold_p\u003c/span\u003e | integer | Minimum free memory (excluding reserved memory) allowed on a node before new shards can no longer be added to it |\n| redis_upgrade_policy | **`major`** \u003cbr /\u003e`latest` | Create/upgrade Redis Enterprise software on databases in the cluster by compatibility with major versions or latest versions of Redis Open Source |\n| repl_diskless | boolean (default: true) | If true, enables the default Redis diskless replication mechanism |\n| resp3_default | boolean (default: true) | Determines the default value of the `resp3` option upon upgrading a database to version 7.2 |\n| shards_overbooking | boolean | If true, all databases' memory_size is ignored during shards placement |\n| show_internals | boolean | Show internal databases (and their shards and endpoints) REST APIs |\n| \u003cspan class=\"break-all\"\u003eshow_metrics_during_state_machine\u003c/span\u003e | boolean | Show metrics during state machine operations |\n| slave_ha | boolean | Enable the replica high-availability mechanism. Deprecated as of Redis Enterprise Software v7.2.4. |\n| \u003cspan class=\"break-all\"\u003eslave_ha_bdb_cooldown_period\u003c/span\u003e | integer | Time in seconds between runs of the replica high-availability mechanism on different nodes on the same database |\n| slave_ha_cooldown_period | integer | Time in seconds between runs of the replica high-availability mechanism on different nodes on the same database |\n| slave_ha_grace_period | integer | Time in seconds between a node failure and when the replica high-availability mechanism starts relocating shards |\n| slow_log_max_len | integer (default: 1024) | Set max slow log entries in debug info |\n| use_librdb | boolean | If true, new databases use the new RDB parser instead of the old one |\n| \u003cspan class=\"break-all\"\u003ewitness_disk_update_frequency_divisor\u003c/span\u003e | integer (default: 3) | Redis Enterprise Software updates the witness disk every \u003cspan class=\"break-all\"\u003e`node_max_update_time / witness_disk_update_frequency_divisor`\u003c/span\u003e seconds |\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-04-01T08:10:08-05:00"
}