{
  "schema_version": 2,
  "id": "operate/iris/agent-memory/self-managed",
  "title": "Self-managed Redis Agent Memory",
  "url": "https://redis.io/docs/latest/operate/iris/agent-memory/self-managed/",
  "summary": "Deploy, configure, secure, and operate Redis Agent Memory on a self-managed Kubernetes cluster.",
  "aliases": [
    "/develop/ai/context-engine/agent-memory/self-managed/"
  ],
  "tags": [
    "docs",
    "operate",
    "iris"
  ],
  "last_updated": "2026-10-21T18:51:10+03:00",
  "children": [
    {
      "id": "operate/iris/agent-memory/self-managed/prerequisites",
      "summary": "Review software, Redis, network, Secret, image, and sizing prerequisites for self-managed Redis Agent Memory.",
      "title": "Self-managed Redis Agent Memory prerequisites",
      "url": "https://redis.io/docs/latest/operate/iris/agent-memory/self-managed/prerequisites/"
    },
    {
      "id": "operate/iris/agent-memory/self-managed/configuration",
      "summary": "Configure the Redis Agent Memory Data Plane, Control Plane, and Identity Service from Helm values, or bring your own configuration files.",
      "title": "Configuration",
      "url": "https://redis.io/docs/latest/operate/iris/agent-memory/self-managed/configuration/"
    },
    {
      "id": "operate/iris/agent-memory/self-managed/deploy",
      "summary": "Install Redis Agent Memory with chart-rendered configuration and agent-key authentication, then make one authenticated call.",
      "title": "Deploy Redis Agent Memory",
      "url": "https://redis.io/docs/latest/operate/iris/agent-memory/self-managed/deploy/"
    },
    {
      "id": "operate/iris/agent-memory/self-managed/authentication",
      "summary": "Configure Redis Agent Memory self-managed Control Plane authentication, Data Plane auth modes, worker callbacks, and gateway integration.",
      "title": "Authentication and authorization",
      "url": "https://redis.io/docs/latest/operate/iris/agent-memory/self-managed/authentication/"
    },
    {
      "id": "operate/iris/agent-memory/self-managed/api-examples",
      "summary": "Use curl examples with the Redis Agent Memory self-managed Control Plane and Data Plane APIs.",
      "title": "Self-managed API examples",
      "url": "https://redis.io/docs/latest/operate/iris/agent-memory/self-managed/api-examples/"
    },
    {
      "id": "operate/iris/agent-memory/self-managed/control-plane-api-reference",
      "summary": "",
      "title": "Redis Agent Memory Control Plane API reference",
      "url": "https://redis.io/docs/latest/operate/iris/agent-memory/self-managed/control-plane-api-reference/"
    },
    {
      "id": "operate/iris/agent-memory/self-managed/operations",
      "summary": "Operate Redis Agent Memory with backups, secret rotation, updates, FIPS posture, and network policy.",
      "title": "Operations",
      "url": "https://redis.io/docs/latest/operate/iris/agent-memory/self-managed/operations/"
    },
    {
      "id": "operate/iris/agent-memory/self-managed/reference",
      "summary": "Review self-managed Redis Agent Memory configuration, troubleshooting guidance, and reference links.",
      "title": "Configuration and troubleshooting",
      "url": "https://redis.io/docs/latest/operate/iris/agent-memory/self-managed/reference/"
    }
  ],
  "page_type": "content",
  "content_hash": "817512a5163d03249a6f30986de2da67469684c942c0ed2e021c9030a32e8e7d",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Redis Agent Memory provides persistent memory for AI agents and\napplications. Applications write conversation events and long-term memories to\nRedis Agent Memory, then query Redis Agent Memory for relevant context before calling an LLM.\n\nThis guide covers deployment, configuration, security, validation, API examples,\nand operations for self-managed Redis Agent Memory. To install, start with\n[Prerequisites](https://redis.io/docs/latest/operate/iris/agent-memory/self-managed/prerequisites), then follow\n[Deploy](https://redis.io/docs/latest/operate/iris/agent-memory/self-managed/deploy).\n\nThe [Redis Agent Memory API](https://redis.io/docs/latest/develop/ai/context-engine/agent-memory/api-reference)\nis the shared Data Plane API for Redis Cloud and self-managed deployments. The\n[Control Plane API reference](https://redis.io/docs/latest/operate/iris/agent-memory/self-managed/control-plane-api-reference)\ndocuments the self-managed admin endpoints for stores."
    },
    {
      "id": "what-you-are-deploying",
      "title": "What you are deploying",
      "role": "content",
      "text": "The `redis-agent-memory` chart `0.8.0` deploys the Data Plane, workers, and Control Plane.\nInstall the `iris-identity-service` chart `0.10.0` as a separate release first, then connect\nMemory to it. Memory does not deploy Identity Service resources or include it as a subchart.\nYou provide the Redis databases. Follow [Deploy](https://redis.io/docs/latest/operate/iris/agent-memory/self-managed/deploy)\nto configure both releases.\n\n| Component | Purpose | Default service |\n| --- | --- | --- |\n| Redis Agent Memory Data Plane | Store-scoped runtime memory API. | `redis-agent-memory:9000` |\n| Redis Agent Memory worker | Background promotion, summarization, and forgetting work. | No public service |\n| Redis Agent Memory Control Plane | Admin API for creating and managing stores. | `redis-agent-memory-controlplane:9100` |\n| Identity Service (separate release) | Mints, rotates, revokes, and checks agent keys. | `ids-iris-identity-service:9200` for release `ids` |\n| Store Redis | Holds session memory, long-term memory, indexes, and TTL data. | Customer-provided |\n| Job Redis | Holds background work for Redis Agent Memory workers. | Customer-provided |\n| Metadata Redis | Holds Control Plane store records. The Identity Service keeps agent-key records in the Metadata Redis named in its own metadata Secret. | Customer-provided |"
    },
    {
      "id": "how-the-components-work-together",
      "title": "How the components work together",
      "role": "content",
      "text": "The Data Plane handles runtime memory requests. The Control Plane handles store administration,\nand the Identity Service handles agent keys.\n\n| Flow | Caller | Service | Backing Redis |\n| --- | --- | --- | --- |\n| Store administration | Platform admin | Redis Agent Memory Control Plane | Metadata Redis |\n| Agent-key administration | Platform admin | Identity Service | Identity Service Metadata Redis |\n| Runtime memory requests | Agent, app, or gateway | Redis Agent Memory Data Plane | Store Redis |\n| Background memory processing | Redis Agent Memory worker | Redis Agent Memory Data Plane | Job Redis and Store Redis |\n\n1. Platform admins create stores with the Control Plane and mint agent keys with the Identity Service.\n1. The Control Plane keeps store records in Metadata Redis. The Identity Service keeps agent-key\n   records in its own Metadata Redis.\n1. Agents and applications call the Data Plane with a store ID and an agent key.\n1. The Data Plane checks each agent key by calling the Identity Service, then reads or writes memory\n   in Store Redis.\n1. Workers use Job Redis for background work and write generated memory to Store Redis."
    },
    {
      "id": "api-surfaces",
      "title": "API surfaces",
      "role": "content",
      "text": "Memory data APIs are scoped to a store, the logical isolation boundary for memory data.\nService liveness and readiness endpoints are not store-scoped.\n\nWhen agent-key authentication is enabled, the grants on each agent key determine which stores and\nactions the key can access.\n\n| API surface | Endpoint prefix | Purpose |\n| --- | --- | --- |\n| Session memory | `/v1/stores/{storeId}/session-memory` | Ordered conversation events, session metadata, and session lifecycle operations. |\n| Long-term memory | `/v1/stores/{storeId}/long-term-memory` | Searchable facts, preferences, summaries, and custom memory records. |\n| Namespaces | `/v1/stores/{storeId}/namespaces` | Namespace resources within a store. |\n| Model Context Protocol (MCP) | `/v1/stores/{storeId}/mcp` | The MCP streamable-HTTP endpoint for a store. |\n| Store health | `/v1/stores/{storeId}/health` | Read-only health for store-scoped features. |\n| Service health | `/health/liveness`, `/health/readiness` | Process liveness and readiness to serve requests; neither requires an agent key. |\n| Control Plane | `/v1/stores`, `/v1/detectors` | Self-managed administration for stores, and the catalog of built-in sensitive-data detectors. |\n| Identity Service | `/v1/api-keys` | Self-managed administration for agent keys. |\n\nSession memory keeps conversation continuity within a session. Long-term memory\nprovides searchable context across sessions.\n\nLong-term memory `memoryType` is an open identifier. When omitted on create,\nRedis Agent Memory stores the record as `semantic`; built-in names include `semantic`,\n`episodic`, `message`, and `session_summary_view`."
    }
  ],
  "examples": []
}