feat(graph): add Neo4j service and graph memory env vars

Adds neo4j:5-community to all compose configurations (stack-r720.yml,
compose.one.yml, compose.split.yml). Graph memory is opt-in: set
NEO4J_URL + NEO4J_PASSWORD on the store service to enable; leave blank
to disable (default).

Ports: 7474 (browser UI), 7687 (Bolt).
Volume: foxmemory_neo4j_data for persistence.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: 2 people

.env.example

@@ -24,3 +24,13 @@ QDRANT_COLLECTION=foxmemory
 # Backward-compatible fields used by some builds/scripts
 QDRANT_HOST=qdrant
 QDRANT_PORT=6333
+
+# Graph memory (Neo4j) — optional.
+# Set NEO4J_URL + NEO4J_PASSWORD to enable. Leave blank to disable.
+# NEO4J_AUTH must match NEO4J_PASSWORD (format: neo4j/<password>).
+# MEM0_GRAPH_LLM_MODEL: recommended gpt-4o-mini (hosted) or Qwen2.5-14B-Instruct (local).
+NEO4J_AUTH=neo4j/changeme
+NEO4J_URL=bolt://neo4j:7687
+NEO4J_USERNAME=neo4j
+NEO4J_PASSWORD=changeme
+MEM0_GRAPH_LLM_MODEL=

compose.one.yml

@@ -10,6 +10,17 @@ services:
       - OLLAMA_CHAT_MODEL=${OLLAMA_CHAT_MODEL}
       - INFER_API_KEY=${INFER_API_KEY}
 
+  neo4j:
+    image: neo4j:5-community
+    container_name: foxmemory-neo4j
+    ports:
+      - "7474:7474"   # HTTP browser UI
+      - "7687:7687"   # Bolt
+    environment:
+      - NEO4J_AUTH=${NEO4J_AUTH:-neo4j/changeme}
+    volumes:
+      - foxmemory_neo4j_data:/data
+
   store:
     image: ${FOXMEMORY_STORE_IMAGE}
     container_name: foxmemory-store
@@ -28,10 +39,17 @@ services:
       - QDRANT_COLLECTION=${QDRANT_COLLECTION}
       - MEM0_HISTORY_DB_PATH=/tmp/history.db
       - QDRANT_STORAGE_PATH=/qdrant/storage
+      # Graph memory — leave NEO4J_URL unset to disable
+      - NEO4J_URL=${NEO4J_URL:-}
+      - NEO4J_USERNAME=${NEO4J_USERNAME:-neo4j}
+      - NEO4J_PASSWORD=${NEO4J_PASSWORD:-}
+      - MEM0_GRAPH_LLM_MODEL=${MEM0_GRAPH_LLM_MODEL:-}
     volumes:
       - foxmemory_store_data:/qdrant/storage
     depends_on:
       - infer
+      - neo4j
 
 volumes:
   foxmemory_store_data:
+  foxmemory_neo4j_data:

compose.split.yml

@@ -10,6 +10,16 @@ services:
       - OLLAMA_CHAT_MODEL=${OLLAMA_CHAT_MODEL}
       - INFER_API_KEY=${INFER_API_KEY}
 
+  neo4j:
+    image: neo4j:5-community
+    ports:
+      - "7474:7474"   # HTTP browser UI
+      - "7687:7687"   # Bolt
+    environment:
+      - NEO4J_AUTH=${NEO4J_AUTH:-neo4j/changeme}
+    volumes:
+      - foxmemory_neo4j_data:/data
+
   store:
     image: ${FOXMEMORY_STORE_IMAGE}
     labels:
@@ -27,8 +37,16 @@ services:
       - QDRANT_COLLECTION=${QDRANT_COLLECTION}
       - MEM0_HISTORY_DB_PATH=/tmp/history.db
       - QDRANT_STORAGE_PATH=/qdrant/storage
+      # Graph memory — leave NEO4J_URL unset to disable
+      - NEO4J_URL=${NEO4J_URL:-}
+      - NEO4J_USERNAME=${NEO4J_USERNAME:-neo4j}
+      - NEO4J_PASSWORD=${NEO4J_PASSWORD:-}
+      - MEM0_GRAPH_LLM_MODEL=${MEM0_GRAPH_LLM_MODEL:-}
     volumes:
       - foxmemory_store_data:/qdrant/storage
+    depends_on:
+      - neo4j
 
 volumes:
   foxmemory_store_data:
+  foxmemory_neo4j_data:

portainer/env-r720.example

@@ -7,3 +7,13 @@ FOXMEMORY_STORE_IMAGE=docker.io/foxlightfoundation/foxmemory-store:latest
 MEM0_LLM_MODEL=gpt-4.1-nano
 MEM0_EMBED_MODEL=text-embedding-3-small
 QDRANT_COLLECTION=foxmemory
+
+# Graph memory (Neo4j) — optional.
+# Set NEO4J_URL + NEO4J_PASSWORD to enable. Leave blank to disable.
+# NEO4J_AUTH must match NEO4J_PASSWORD (format: neo4j/<password>).
+# MEM0_GRAPH_LLM_MODEL: recommended gpt-4o-mini (hosted) or Qwen2.5-14B-Instruct (local).
+NEO4J_AUTH=neo4j/changeme
+NEO4J_URL=bolt://neo4j:7687
+NEO4J_USERNAME=neo4j
+NEO4J_PASSWORD=changeme
+MEM0_GRAPH_LLM_MODEL=gpt-4o-mini

portainer/stack-r720.yml

@@ -12,6 +12,18 @@ services:
     volumes:
       - foxmemory_store_data:/qdrant/storage
 
+  neo4j:
+    image: neo4j:5-community
+    container_name: foxmemory-neo4j
+    restart: unless-stopped
+    ports:
+      - "7474:7474"   # HTTP browser UI
+      - "7687:7687"   # Bolt (used by foxmemory-store)
+    environment:
+      NEO4J_AUTH: ${NEO4J_AUTH:-neo4j/changeme}
+    volumes:
+      - foxmemory_neo4j_data:/data
+
   store:
     image: ${FOXMEMORY_STORE_IMAGE:-docker.io/foxlightfoundation/foxmemory-store:latest}
     container_name: foxmemory-store
@@ -31,8 +43,15 @@ services:
       QDRANT_COLLECTION: ${QDRANT_COLLECTION:-foxmemory}
       MEM0_HISTORY_DB_PATH: /tmp/history.db
       QDRANT_STORAGE_PATH: /qdrant/storage
+      # Graph memory — leave NEO4J_URL unset to disable
+      NEO4J_URL: ${NEO4J_URL:-}
+      NEO4J_USERNAME: ${NEO4J_USERNAME:-neo4j}
+      NEO4J_PASSWORD: ${NEO4J_PASSWORD:-}
+      MEM0_GRAPH_LLM_MODEL: ${MEM0_GRAPH_LLM_MODEL:-}
     depends_on:
       - qdrant
+      - neo4j
 
 volumes:
   foxmemory_store_data:
+  foxmemory_neo4j_data: