{
  "schema_version": 2,
  "id": "operate/rc/rdi/create-workspace",
  "title": "Create and manage Data Integration workspace",
  "url": "https://redis.io/docs/latest/operate/rc/rdi/create-workspace/",
  "summary": "Create and manage the infrastructure for your Data Integration pipelines.",
  "aliases": [
    "/operate/rc/databases/rdi/create-workspace",
    "/operate/rc/databases/rdi/create-workspace/"
  ],
  "tags": [
    "docs",
    "operate",
    "rc"
  ],
  "last_updated": "2026-10-12T14:51:21+03:00",
  "page_type": "content",
  "content_hash": "6980c52e69528c854ab7adceb6354d1f5ad76218cca3ce008ebe7ddb16c6254c",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Before you can create your first Data Integration pipeline for a Redis Cloud subscription, you must first deploy the cloud infrastructure needed to host the pipeline and run the workers associated with the pipeline. In Redis Cloud, this is called a **Workspace**. Each Pro subscription can have one Data integration workspace. You only need to set up the workspace once - any pipelines you create for your subscription will run on the workspace until you delete it. You won't be charged for a workspace until you start running your Data Integration pipeline."
    },
    {
      "id": "create-a-data-integration-workspace",
      "title": "Create a Data Integration workspace",
      "role": "content",
      "text": "For multiple source databases or Redis subscriptions, see [Plan source connectivity](https://redis.io/docs/latest/operate/rc/rdi/networking). It explains which endpoint services you can reuse and which connections you configure for each workspace.\n\nTo create a Data Integration workspace for an existing [Pro subscription](https://redis.io/docs/latest/operate/rc/databases/create-database/create-pro-database-new):\n\n1. In the Redis Cloud console, select **Data Integration**.\n\n2. Select **Create workspace** if you have no workspaces yet.\n\n    ![The create workspace button.](https://redis.io/docs/latest/images/rc/rdi/rdi-create-workspace-button.png)\n\n    If you already have a workspace, select **New workspace**.\n\n    ![The new workspace button.](https://redis.io/docs/latest/images/rc/rdi/rdi-new-workspace-button.png)\n\n    You can also open **Data Integration** from a subscription or database page.\n    Select **Create workspace** to use that subscription.\n\n    ![The create workspace button.](https://redis.io/docs/latest/images/rc/rdi/rdi-create-workspace-button.png)\n\n3. Select your Pro subscription if it is not already selected.\n\n    ![The select pro subscription drop down.](https://redis.io/docs/latest/images/rc/rdi/rdi-create-workspace-select-subscription.png)\n\n4. Review **Data Integration subnet (CIDR)**. The console suggests a dedicated\n   `/22` Classless Inter-Domain Routing (CIDR) range for the workspace.\n\n    [Plan network capacity for all pipelines](https://redis.io/docs/latest/operate/rc/rdi/scale-pipeline#plan-workspace-network-capacity)\n    before you create the workspace. Choose a `/21` or larger range if you plan\n    more than 5 sources or more than 5 processor replicas in total.\n    These counts are a conservative planning trigger, not a capacity limit.\n    You cannot enlarge the workspace CIDR after creation.\n\n    For Amazon Web Services (AWS), the RDI workspace CIDR must:\n\n    - Be in the same [RFC 1918 private address range](https://datatracker.ietf.org/doc/html/rfc1918#section-3) as the subscription virtual private cloud (VPC)'s primary CIDR: `10.0.0.0/8`, `172.16.0.0/12`, or `192.168.0.0/16`.\n    - Not overlap with existing subscription, peering, transit gateway (TGW), application, database, or RDI workspace CIDR ranges.\n\n    For example, a subscription VPC has the primary CIDR `10.238.252.0/24`.\n    The range `192.168.0.0/22` is invalid because it is in a different\n    RFC 1918 range. An unused range such as `10.239.0.0/22` is valid.\n\n    If the suggestion is missing or unsuitable, select another unused range.\n    It must meet your capacity needs and use the same private address range.\n    See [VPC CIDR block association restrictions](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-cidr-blocks.html#vpc-resize).\n\n    ![The select pro subscription drop down.](https://redis.io/docs/latest/images/rc/rdi/rdi-create-workspace-cidr.png)\n\n5. Select **Create workspace**.\n\n    ![The create workspace button.](https://redis.io/docs/latest/images/rc/rdi/rdi-create-workspace-button.png)\n\nRedis Cloud creates the workspace in the background. Select **Create pipeline**\nto [create your pipeline](https://redis.io/docs/latest/operate/rc/rdi/define) while it provisions.\nSelect **Create pipeline later** to return to the Redis Cloud console.\n\n\n![The Add pipeline control is available while the workspace is being created.](https://redis.io/docs/latest/images/rc/rdi/rdi-workspace-add-pipeline.png)"
    },
    {
      "id": "view-workspace-status-and-details",
      "title": "View workspace status and details",
      "role": "content",
      "text": "You can view your workspace in one of the following ways:\n\n- From the Redis Cloud console, go to the **Data integration** page, or\n- From your subscription, select the **Data Integration** tab\n\n![Workspace pipeline list showing a streaming pipeline and its Sources column.](https://redis.io/docs/latest/images/rc/rdi/rdi-2-workspace-sources.png)\n\nThere, you'll see your workspace and its pipelines. The **Sources** column lists each pipeline's source names and database types. A source with unfinished configuration is marked **Pending setup**. Open its draft to continue setup. To see your workspace details, including the deployment CIDR and region information, select **Workspace actions > Workspace details**.\n\n![Workspace actions menu with Workspace details and Delete workspace.](https://redis.io/docs/latest/images/rc/rdi/rdi-2-workspace-actions.png)"
    },
    {
      "id": "delete-workspace",
      "title": "Delete workspace",
      "role": "content",
      "text": "> [!WARNING]\n> Make sure to [delete your data pipeline](https://redis.io/docs/latest/operate/rc/rdi/view-edit#delete-pipeline) before deleting your workspace.\n\nTo delete your workspace, select **Workspace actions > Delete workspace** from your workspace.\n\n![Workspace actions menu with Workspace details and Delete workspace.](https://redis.io/docs/latest/images/rc/rdi/rdi-2-workspace-actions.png)"
    }
  ],
  "examples": []
}