RedisGraph to FalkorDB Migration

FalkorDB is fully compatible with RedisGraph RDB (Redis Database) files, making migration straightforward.

Migration Steps

Step 1: Create RDB Snapshot from RedisGraph

Create a snapshot of your RedisGraph database using the SAVE or BGSAVE command:

# Connect to your RedisGraph instance
redis-cli

# Create snapshot (blocks server during save)
SAVE

# Or create snapshot in background (recommended for production)
BGSAVE

This creates a dump.rdb file in your Redis data directory.

Step 2: Load RDB File into FalkorDB

Using Docker

When using the FalkorDB Docker image, mount your RDB file and configure Redis to load it:

   docker run -it -p 6379:6379 -v $(pwd):/data -e REDIS_ARGS="--dir /data --dbfilename dump.rdb" falkordb/falkordb

Make sure to place the RDB file in the directory mapped to the Docker volume. For FalkorDB Cloud, follow the cloud provider’s instructions for uploading and restoring from an RDB file.

Important: Ensure your dump.rdb file is placed in the directory mapped to the Docker volume ($(pwd) in the example above).

Using FalkorDB Cloud

For FalkorDB Cloud deployments, follow the cloud provider’s instructions for uploading and restoring from an RDB file.

Verification

After loading the RDB file, verify your data:

# Connect to FalkorDB
redis-cli

# List all graphs
GRAPH.LIST

# Query a graph to verify data
GRAPH.QUERY your_graph_name "MATCH (n) RETURN count(n)"

Best Practices

  • Verify RDB Integrity: Check the RDB file integrity before and after transfer
  • Plan for Downtime: Consider downtime requirements and data consistency during migration
  • Test First: Always test the migration in a staging environment before production
  • Backup: Keep backups of both the source RedisGraph data and the RDB file
  • Monitor: After migration, monitor FalkorDB performance and verify queries work correctly
Frequently Asked Questions 4
Is FalkorDB fully compatible with RedisGraph RDB files?

Yes. FalkorDB is fully compatible with RedisGraph RDB files. Simply load your existing dump.rdb into FalkorDB and your graphs will be available immediately.

Do I need to stop RedisGraph before creating the RDB snapshot?

For a consistent snapshot, use BGSAVE which creates a background snapshot without blocking the server. For absolute consistency, use SAVE which blocks but ensures no writes during the snapshot.

Can I migrate from RedisGraph Cloud to FalkorDB Cloud?

Yes. Export an RDB file from your RedisGraph Cloud instance, then follow your FalkorDB Cloud provider instructions for uploading and restoring from the RDB file.

Will my existing RedisGraph client code work with FalkorDB?

Yes. FalkorDB is API-compatible with RedisGraph. Your existing client code using GRAPH.QUERY and GRAPH.RO_QUERY commands will work without modifications.