{
  "schema_version": 2,
  "id": "operate/rs/references/rest-api/objects/crdb/database_config",
  "title": "CRDB database config object",
  "url": "https://redis.io/docs/latest/operate/rs/7.4/references/rest-api/objects/crdb/database_config/",
  "summary": "An object that represents the database configuration",
  "content": "\nAn object that represents the database configuration. This configuration object is used in two contexts within CRDB objects:\n\n- As `default_db_config` in the main [CRDB object](https://redis.io/docs/latest/operate/rs/references/rest-api/objects/crdb) for settings that apply to all instances. In most cases, instances should use the same configuration.\n\n- As `db_config` in individual [instance objects](https://redis.io/docs/latest/operate/rs/references/rest-api/objects/crdb/instance_info) to override `default_db_config` or add configuration values for specific instances. Use `db_config` only when an instance needs different settings than the default configuration.\n\n| Name | Type/Value | Description |\n|------|------------|-------------|\n| aof_policy | string | Policy for Append-Only File data persistence |\n| \u003cspan class=\"break-all\"\u003eauthentication_admin_pass\u003c/span\u003e | string | Administrative databases access token |\n| \u003cspan class=\"break-all\"\u003eauthentication_redis_pass\u003c/span\u003e | string | Redis AUTH password (deprecated as of Redis Enterprise v7.2, replaced with multiple passwords feature in version 6.0.X) |\n| bigstore | boolean | Database driver is Auto Tiering |\n| bigstore_ram_size | integer | Memory size of RAM size |\n| data_persistence | string | Database on-disk persistence |\n| \u003cspan class=\"break-all\"\u003eenforce_client_authentication\u003c/span\u003e | **'enabled'** \u003cbr /\u003e'disabled' | Require authentication of client certificates for SSL connections to the database. If enabled, a certificate should be provided in either \u003cspan class=\"break-all\"\u003e`authentication_ssl_client_certs`\u003c/span\u003e or \u003cspan class=\"break-all\"\u003e`authentication_ssl_crdt_certs`\u003c/span\u003e |\n| max_aof_file_size | integer | Hint for maximum AOF file size |\n| max_aof_load_time | integer | Hint for maximum AOF reload time |\n| memory_size | integer | Database memory size limit, in bytes |\n| module_list | array of module objects | List of modules to be loaded to all participating clusters of the Active-Active database\u003cbr /\u003e[{\u003cbr /\u003e  \"module_id\": string,\u003cbr /\u003e  \"module_args\": string,\u003cbr /\u003e  \"module_name\": string,\u003cbr /\u003e  \"semantic_version\": string\u003cbr /\u003e}, ...]\u003cbr /\u003e**module_id**: Module UID \u003cbr /\u003e**module_args**: Module command-line arguments (pattern does not allow special characters \u0026,\\\u003c,\u003e,\")\u003cbr /\u003e**module_name**: Module's name\u003cbr /\u003e**semantic_version**: Module's semantic version\u003cbr /\u003e\u003cbr /\u003eAs of Redis Enterprise Software v7.4.2, **module_id** and **semantic_version** are optional. |\n| oss_cluster | boolean | Enables OSS Cluster mode |\n| \u003cspan class=\"break-all\"\u003eoss_cluster_api_preferred_ip_type\u003c/span\u003e | 'internal'\u003cbr /\u003e'external' | Indicates preferred IP type in OSS cluster API |\n| oss_sharding | boolean | An alternative to shard_key_regex for using the common case of the OSS shard hashing policy |\n| port | integer | TCP port for database access |\n| proxy_policy | string | The policy used for proxy binding to the endpoint |\n| rack_aware | boolean | Require the database to be always replicated across multiple racks |\n| replication | boolean | Database replication |\n| sharding | boolean (default:\u0026nbsp;false) | Cluster mode (server-side sharding). When true, shard hashing rules must be provided by either `oss_sharding` or `shard_key_regex` |\n| shard_key_regex | `[{ \"regex\": string }, ...]` | Custom keyname-based sharding rules (required if sharding is enabled)\u003cbr /\u003e\u003cbr /\u003eTo use the default rules you should set the value to:\u003cbr /\u003e`[{\"regex\": \".*\\\\{(?\u003ctag\u003e.*)\\\\}.*\"}, {\"regex\": \"(?\u003ctag\u003e.*)\"}]` |\n| shards_count | integer | Number of database shards |\n| shards_placement | string | Control the density of shards: should they reside on as few or as many nodes as possible |\n| snapshot_policy | array of [snapshot_policy](https://redis.io/docs/latest/operate/rs/references/rest-api/objects/bdb/snapshot_policy) objects | Policy for snapshot-based data persistence (required) |\n| tls_mode | string | Encrypt communication |\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-10-21T09:46:20-07:00"
}