Neo4j Migrations

Automated script runner aka "Migrations" for Neo4j. Inspired by Flyway.
Alternatives To Neo4j Migrations
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Migrate11,47759416 hours ago129March 17, 2022269otherGo
Database migrations. CLI and Golang library.
Liquigraph122554 months ago20February 21, 202210apache-2.0Java
Migrations for Neo4j
Neo4j Migrations89412 hours ago46August 15, 20227apache-2.0Java
Automated script runner aka "Migrations" for Neo4j. Inspired by Flyway.
20 days ago3mitTypeScript
Morpheus is database migration tool for Neo4j written in Typescript.
Mlistdata Mysql Neo4j9
4 years ago1gpl-3.0Python
An example which shows how to migrate MySQL to Neo4j data. I cannot provide the data as it is private but I have provided the equivalent SQL schema and the Property Graph Models that both represent a mailing list application. I hope this serves as a useful as a reference when you are writing your own migrations.
Neo4j Data Migrations9
3 years ago11September 23, 2020mitJavaScript
NodeJS library to allow easy data migrations for Neo4j graph databases.
Td Dl6
2 years ago3gpl-3.0Python
/truedat back-end service to manage lineage model
Postgresql To Neo4j Etl2
4 years agoShell
ETL tool for postgres rdbms to neo4j graph db
Sdn Migration2
2 years ago2Java
Mostool Neo4j1
12 years ago
Migration project from SqLite to Neo4J
Alternatives To Neo4j Migrations
Select To Compare

Alternative Project Comparisons


Neo4j-Migrations is a database migration and refactoring tool that allows running Cypher scripts and programmatic refactorings in a controlled and repeatable fashion against one or more Neo4j database.

Neo4j-Migrations is a proud member of the Neo4j-Labs and maintained by authors of the Neo4j-Drivers- and SDN/OGM team.

badge measure?project=eu.michael simons measure?project=eu.michael simons badge


Neo4j-Migrations are a set of tools to make your schema migrations as easy as possible. They provide a uniform way for applications, the command line and build tools alike to track, manage and apply changes to your database, in short: to refactor your database. The project is inspired to a large extent by FlywayDB, which is an awesome tool for migration of relational databases. Most things evolve around Cypher scripts, however the Core API of Neo4j-Migrations allows defining Java classes as migrations as well.

Neo4j-Migrations builds directly on top of the official Neo4j Java driver, supports Neo4j 3.5, Neo4j 4.1 to 4.4 and Neo4j 5, including enterprise features such as multidatabase support and impersonation.

The only dependencies are said driver and ClassGraph, the latter being used to find migrations on the classpath.

The history of migrations applied is stored as a subgraph in your database.

The graph will look like this:

chain of migrations


Binary downloads for the CLI are available on our release page for each version. Maven artifacts are available on central under the following coordinates:

  • Core API: eu.michael-simons.neo4j:neo4j-migrations:2.4.0

  • Spring-Boot-Starter: eu.michael-simons.neo4j:neo4j-migrations-spring-boot-starter:2.4.0

  • Quarkus extension: eu.michael-simons.neo4j:neo4j-migrations-quarkus:2.4.0

  • Maven-Plugin: eu.michael-simons.neo4j:neo4j-migrations-maven-plugin:2.4.0

The quickest way to use the CLI is JBang. With JBang installed, just enter jbang [email protected] --help to get started. Other options include Homebrew and Zip bundles. Please checkout the full list of download options.


Neo4j-Migrations can be used against Neo4j 3.5, all Neo4j 4 versions from 4.1 up to 4.4 and Neo4j 5, including all current Neo4j-Aura versions.

Neo4j 4.0 is only partially supported since version 2.0 due to the fact that Neo4j Java Driver does not support it fully anymore since 5.x. If you need to use this library with Neo4j 4.0 (which you shouldn’t, because 4.0 is out of support anyway), look at the latest 1.x version of Neo4j-Migrations. This does not affect new versions of the 4.x series, such as Neo4j 4.4, which is fully supported by this project!

The Core API and the JVM based version of the CLI module of Neo4j-Migrations requires at least Java 17 or higher since version 2.0. Neo4j-Migrations can safely be used on both the class- and module-path. Native binaries are provided for 64bit versions of macOS, Linux and Windows. The native binaries don’t require a JVM to be installed.

For a version compatible with JDK 8, check the 1.x releases. We still do maintain the latest minor, including support for older versions of Spring Boot (prio to Spring Boot 3). These are also the versions you should be using against Neo4j 4.0.

The older releases of Neo4j-Migrations are compiled with JDK 17 while targeting JDK 8. The Core API is provided as a Multi-Release-Jar in the older releases, providing a for JDK 11 and higher, making it a good citizen on the Java module path as well.

While the CLI module actually does not require a JVM installed (it is a native binary, available for a Linux, macOS and Windows alike), some people might prefer a solution native to their ecosystem. The following projects serve the same purpose as Neo4j-Migrations and use the same graph, check-summing and versioning scheme as this project:

If you want to be listed here too, please reach out, and we can collaborate to ensure compatibility.


The complete manual is available here: The API documentation for the core module is available here: Neo4j Migrations (Core) 2.4.0 API. The comprehensive set of system diagrams including build, module and class diagrams is automatically generated weekly.

Presentations and features

We try to promote this project as good as we can internally and externally while trying not to be too obtrusive. If you think it’s a good idea to talk about it at your conference, just ask. Happy to answer CfPs. We are grateful about the coverage, presentations and features so far:

CLI in a nutshell

cli demo
Popular Neo4j Projects
Popular Migration Projects
Popular Data Storage Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Database Migrations