Graph Database Configuration
Graphiti supports two graph database backends: Neo4j and FalkorDB. This guide covers installation and configuration options for both databases across different deployment scenarios.
Neo4j
Neo4j is the primary graph database backend for Graphiti. Version 5.26 or higher is required for full functionality.
Neo4j Community Edition
Neo4j Community Edition is free and suitable for development, testing, and smaller production workloads.
Installation via Neo4j Desktop
The simplest way to install Neo4j is via Neo4j Desktop, which provides a user-friendly interface to manage Neo4j instances and databases.
- Download and install Neo4j Desktop
- Create a new project
- Add a new database (Local DBMS)
- Set a password for the
neo4j
user - Start the database
Docker Installation
For containerized deployments:
Configuration
Set the following environment variables:
Connection in Python
Neo4j AuraDB (Cloud)
Neo4j AuraDB is a fully managed cloud service that handles infrastructure, backups, and updates automatically.
Setup
- Sign up for Neo4j Aura
- Create a new AuraDB instance
- Note down the connection URI and credentials
- Download the connection details or copy the connection string
Configuration
AuraDB connections use the neo4j+s://
protocol for secure connections:
Connection in Python
AuraDB instances automatically include APOC procedures. No additional configuration is required for most Graphiti operations.
Neo4j Enterprise Edition
Neo4j Enterprise Edition provides advanced features including clustering, hot backups, and performance optimizations.
Installation
Enterprise Edition requires a commercial license. Installation options include:
- Neo4j Desktop: Add Enterprise Edition license key
- Docker: Use
neo4j:5.26-enterprise
image with license - Server Installation: Download from Neo4j website with valid license
Docker with Enterprise Features
Parallel Runtime Configuration
Enterprise Edition supports parallel runtime for improved query performance:
The USE_PARALLEL_RUNTIME
feature is only available in Neo4j Enterprise Edition and larger AuraDB instances. It is not supported in Community Edition or smaller AuraDB instances.
Connection in Python
FalkorDB
FalkorDB configuration requires version 1.1.2 or higher.
Docker Installation
The simplest way to run FalkorDB is via Docker:
This command:
- Exposes FalkorDB on port 6379 (Redis protocol)
- Provides a web interface on port 3000
- Runs in foreground mode for easy testing
Configuration
Set the following environment variables for FalkorDB (optional):
Connection in Python
FalkorDB uses a dedicated FalkorDriver
and connects via Redis protocol on port 6379. Unlike Neo4j, authentication is typically not required for local FalkorDB instances.