graphiti Docker & Self-Hosted Deployment

GitHub

Build Real-Time Knowledge Graphs for AI Agents

32,143 stars Python Python 15 files ยท ~25,963 tokens #agents#graph#llms#rag
RAW Compose
1. Pull Image (DOCKERHUB) docker pull zepai/knowledge-graph-mcp
2. Docker Run (1-Click Launch) docker run -d --name graphiti -p 6379:6379 --restart always zepai/knowledge-graph-mcp:latest
3. Podman Run podman run -d --name graphiti -p 6379:6379 --restart always zepai/knowledge-graph-mcp:latest
4. Skopeo Inspect (Zero-Pull Manifest) skopeo inspect docker://docker.io/zepai/knowledge-graph-mcp:latest
5. ORAS Pull (OCI Artifact) oras pull zepai/knowledge-graph-mcp:latest
6. Compose Deployment docker compose up -d
mcp_server/docker/docker-compose.yml
Download .yml
services:
  graphiti-falkordb:
    image: zepai/knowledge-graph-mcp:latest
    build:
      context: ..
      dockerfile: docker/Dockerfile
      args:
        GRAPHITI_CORE_VERSION: ${GRAPHITI_CORE_VERSION:-0.29.1}
        MCP_SERVER_VERSION: ${MCP_SERVER_VERSION:-1.1.3}
        BUILD_DATE: ${BUILD_DATE:-}
        VCS_REF: ${VCS_REF:-}
    env_file:
      - path: ../.env
        required: false
    environment:
      # FalkorDB configuration
      - FALKORDB_PASSWORD=${FALKORDB_PASSWORD:-}
      - BROWSER=${BROWSER:-1}  # Enable FalkorDB Browser UI (set to 0 to disable)
      # MCP Server configuration
      - FALKORDB_URI=redis://localhost:6379
      - FALKORDB_DATABASE=${FALKORDB_DATABASE:-default_db}
      - GRAPHITI_GROUP_ID=${GRAPHITI_GROUP_ID:-main}
      - SEMAPHORE_LIMIT=${SEMAPHORE_LIMIT:-10}
      - CONFIG_PATH=/app/mcp/config/config.yaml
    volumes:
      - falkordb_data:/var/lib/falkordb/data
      - mcp_logs:/var/log/graphiti
    ports:
      - "127.0.0.1:6379:6379"  # FalkorDB/Redis
      - "127.0.0.1:3000:3000"  # FalkorDB web UI
      - "127.0.0.1:8000:8000"  # MCP server HTTP
    healthcheck:
      test: ["CMD", "redis-cli", "-p", "6379", "ping"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 15s

volumes:
  falkordb_data:
    driver: local
  mcp_logs:
    driver: local