{
  "schema_version": 2,
  "id": "operate/rs/databases/create",
  "title": "Create a Redis Software database",
  "url": "https://redis.io/docs/latest/operate/rs/databases/create/",
  "summary": "Create a database with Redis Software.",
  "tags": [
    "docs",
    "operate",
    "rs"
  ],
  "last_updated": "2026-10-01T15:48:36+01:00",
  "page_type": "content",
  "content_hash": "1a5f1b0640df8d6898cc02429a134f0c91b3f1910f2238ad8cc9fa4eabf203fa",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Redis Software lets you create databases and distribute them across a cluster of nodes using the [Cluster Manager UI](#cluster-manager-ui-method) or the [REST API](#rest-api-method)."
    },
    {
      "id": "cluster-manager-ui-method",
      "title": "Cluster Manager UI method",
      "role": "content",
      "text": "To create a new database using the Cluster Manager UI:\n\n1. Sign in to the Cluster Manager UI at `https://<hostname>:8443`\n\n1. Use one of the following methods to create a new database:\n\n    - [Quick database](#quick-database)\n\n    - [Create database with additional configuration](#create-db-ui)\n\n1. If you did not specify a port number for the database, you can find the port number in the **Endpoint** field in the **Databases > Configuration > General** section.\n\n1. [Test client connectivity](https://redis.io/docs/latest/operate/rs/databases/connect/test-client-connectivity).\n\n\n> [!NOTE]\n> For databases with Active-Active replication for geo-distributed locations,\n> see [Create an Active-Active database](https://redis.io/docs/latest/operate/rs/databases/active-active/create). To create and manage Active-Active databases, use the legacy UI."
    },
    {
      "id": "quick-database",
      "title": "Quick database",
      "role": "content",
      "text": "To quickly create a database and skip additional configuration options during initial creation:\n\n1. On the **Databases** screen, select **Quick database**.\n\n1. Select a Redis version from the **Database version** list.\n\n1. Configure settings that are required for database creation but can be changed later:\n\n    - Database name\n\n    - Memory limit (GB)\n\n2. Configure optional settings that can't be changed after database creation:\n\n    - Endpoint port (set by the cluster if not set manually)\n\n    - Capabilities (previously modules) to enable\n\n        Databases created with Redis version 8 or later automatically enable the capabilities (modules) bundled with Redis Software as follows:\n\n        | Database type | Automatically enabled capabilities |\n|---------------|------------------------------------|\n| RAM-only | [Redis Search](https://redis.io/docs/latest/operate/oss_and_stack/stack-with-enterprise/search)<br />[JSON](https://redis.io/docs/latest/operate/oss_and_stack/stack-with-enterprise/json)<br />[Time series](https://redis.io/docs/latest/operate/oss_and_stack/stack-with-enterprise/timeseries)<br />[Probabilistic](https://redis.io/docs/latest/operate/oss_and_stack/stack-with-enterprise/bloom)  |\n| Flash-enabled ([Redis Flex](https://redis.io/docs/latest/operate/rs/databases/flash)) | [JSON](https://redis.io/docs/latest/operate/oss_and_stack/stack-with-enterprise/json)<br />[Probabilistic](https://redis.io/docs/latest/operate/oss_and_stack/stack-with-enterprise/bloom) |\n| [Active-Active](https://redis.io/docs/latest/operate/rs/databases/active-active)<sup>[1](#enabled-modules-table-note-1)</sup> | [Redis Search](https://redis.io/docs/latest/operate/oss_and_stack/stack-with-enterprise/search/search-active-active)<br />[JSON](https://redis.io/docs/latest/operate/oss_and_stack/stack-with-enterprise/json) |\n\n1. <a name=\"enabled-modules-table-note-1\"></a>Upgrading existing Active-Active databases to Redis version 8 does not automatically enable these capabilities. Only new Active-Active databases created with Redis version 8 enable these capabilities by default.\n\n1. Optionally select **Full options** to configure [additional settings](https://redis.io/docs/latest/operate/rs/databases/configure#config-settings).\n\n1. Select **Create**."
    },
    {
      "id": "create-db-ui",
      "title": "Create database with additional configuration",
      "role": "content",
      "text": "To create a new database and configure additional settings:\n\n1. Open the **Create database** menu with one of the following methods:\n\n    - Click the **+** button next to **Databases** in the navigation menu:\n\n        ![Create database menu has two options: Single Region and Active-Active database.](https://redis.io/docs/latest/images/rs/screenshots/databases/create-db-plus-drop-down.png)\n        \n    - Go to the **Databases** screen and select **Create database**:\n\n        ![Create database menu has two options: Single Region and Active-Active database.](https://redis.io/docs/latest/images/rs/screenshots/databases/create-db-button-drop-down.png)\n\n1. Select the database type:\n\n    - **Single Region**\n\n    - **Active-Active database** - Multiple participating Redis Software clusters can host instances of the same [Active-Active database](https://redis.io/docs/latest/operate/rs/databases/active-active) in different geographic locations. Every instance can receive write operations, which are synchronized across all instances without conflict.\n\n    > [!NOTE]\n    > For Active-Active databases, see [Create an Active-Active geo-replicated database](https://redis.io/docs/latest/operate/rs/databases/active-active/create).\n    >\n\n1. Select a Redis version from the **Database version** list.\n\n1. Enter a **Database name**.\n\n    - Maximum of 63 characters\n\n    - Only letters, numbers, or hyphens (-) are valid characters\n\n    - Must start and end with a letter or digit\n\n    - Case-sensitive\n\n1. To configure additional database settings, expand each relevant section to make changes.\n\n    See [Configuration settings](https://redis.io/docs/latest/operate/rs/databases/configure#config-settings) for more information about each setting.\n\n1. Select **Create**."
    },
    {
      "id": "rest-api-method",
      "title": "REST API method",
      "role": "content",
      "text": "To [create a database](https://redis.io/docs/latest/operate/rs/references/rest-api/requests/bdbs#post-bdbs-v1) using a REST API request:\n\n[code example]\n\nFor additional database configuration fields, see the [BDB object](https://redis.io/docs/latest/operate/rs/references/rest-api/objects/bdb) reference."
    },
    {
      "id": "continue-learning-with-redis-university",
      "title": "Continue learning with Redis University",
      "role": "content",
      "text": ""
    }
  ],
  "examples": [
    {
      "id": "rest-api-method-ex0",
      "language": "sh",
      "code": "POST https://<host>:<port>/v1/bdbs\n{\n    \"name\": \"test-database\",\n    \"type\": \"redis\",\n    \"memory_size\": 1073741824,\n    // Additional fields\n}",
      "section_id": "rest-api-method"
    }
  ]
}