Deploy with static stores

Deploy Redis Agent Memory with static stores and no Control Plane.

Use static stores for a first install or a private single-store deployment. In this mode, stores are declared directly in Data Plane configuration. The deployment does not include the Control Plane and does not use Metadata Redis.

Before you begin, review prerequisites and create memory-dataplane.config.yaml from the static stores example.

Create the namespace

kubectl create namespace <namespace-name>

Create Secrets

Create the license Secret:

kubectl -n <namespace-name> create secret generic ram-license \
  --from-file=license=./license

Create the Data Plane config Secret:

kubectl -n <namespace-name> create secret generic ram-config \
  --from-file=memory-dataplane.config.yaml=./memory-dataplane.config.yaml

Create Helm values

Create SHA-256 checksums for externally managed Secrets. These values are used by Helm values to roll pods after Secret changes; they are not used to validate Secret integrity.

LICENSE_CHECKSUM="$(sha256sum ./license | awk '{print $1}')"
CONFIG_CHECKSUM="$(sha256sum ./memory-dataplane.config.yaml | awk '{print $1}')"

LICENSE_CHECKSUM="$(shasum -a 256 ./license | awk '{print $1}')"
CONFIG_CHECKSUM="$(shasum -a 256 ./memory-dataplane.config.yaml | awk '{print $1}')"

Create ram-values.yaml:

license:
  existingSecret: ram-license
  existingSecretChecksum: "<license-checksum>"

config:
  existingSecret: ram-config
  existingSecretChecksum: "<config-checksum>"

image:
  repository: redislabs/agent-memory
  tag: "<ram-version>"

Install the chart

Add the Helm repository when installing from the public repository:

helm repo add redis-ai https://helm.redis.io/ai
helm repo update redis-ai
helm search repo redis-ai/redis-agent-memory --versions

Install with redis-agent-memory as the Helm release name:

helm install redis-agent-memory redis-ai/redis-agent-memory \
  --version <chart-version> \
  --namespace <namespace-name> \
  --create-namespace \
  -f ram-values.yaml

On small clusters, install without --atomic --wait, then watch pod status:

kubectl -n <namespace-name> get pods -w

If you want Helm to wait, set an explicit timeout that matches the environment:

helm install redis-agent-memory redis-ai/redis-agent-memory \
  --version <chart-version> \
  --namespace <namespace-name> \
  --create-namespace \
  -f ram-values.yaml \
  --wait \
  --timeout 15m

Verify the deployment

Check pods:

kubectl -n <namespace-name> get pods -l app.kubernetes.io/name=redis-agent-memory

Port-forward the Data Plane:

kubectl -n <namespace-name> port-forward svc/redis-agent-memory 9000:9000

Check health endpoints:

curl http://localhost:9000/health
curl http://localhost:9000/health/liveness
curl http://localhost:9000/health/readiness

Expected /health response:

{"status":"healthy"}

Do not expose an auth-disabled Data Plane to untrusted callers. Use Kubernetes NetworkPolicy, private service exposure, ingress, gateway, service mesh, or equivalent controls to restrict access.