Neo4j 5 upgrade and migration

Important

It is recommended to read the Introduction before continuing.

Upgrading to 5.x or 5.26 LTS

You can upgrade from any version of Neo4j 5 to any subsequent MINOR or PATCH version, or to the latest 5.26 LTS, by following the instructions in Upgrade to 5.x or 5 LTS.

Migrating databases from Neo4j 4.4 LTS to Neo4j 5.26 LTS

We do not recommend you upgrade a Neo4j 4.4 LTS server to 5.26 LTS. Instead, you should configure the new server and migrate the databases from the old server to the new server.

If you are using Neo4j 4.4, you can migrate your databases to Neo4j 5.26 LTS by following the instructions in Migrate from 4.4 LTS.

Otherwise, you must first migrate your databases to Neo4j 4.4 LTS by following the instructions in the Neo4j 4.4 LTS specific section.

Migrating databases from Neo4j Community Edition to Neo4j Enterprise Edition

You can upgrade from Neo4j 5 Community Edition to Neo4j 5 Enterprise Edition using the following steps. If the information stored in the system database is not required when migrating, you can skip the steps associated with the system database.

  1. Stop the running Neo4j 5 Community Edition server:

    neo4j stop

  2. Backup the system and neo4j databases using the neo4j-admin database dump command:

    neo4j-admin database dump neo4j
    neo4j-admin database dump system

    By default, dumps are located to data/dumps/. Alternatively, the location can be defined via the conf/neo4j.conf setting server.directories.dumps.root.

  3. Load the system and neo4j databases into the Neo4j 5 Enterprise Edition server using neo4j-admin database load:

    neo4j-admin database load neo4j --from-path=<path-to-community-neo4j-dump>
    neo4j-admin database load system --from-path=<path-to-community-system-dump>

  4. Navigate to the Neo4j 5 Enterprise Edition server and start it:

    neo4j start

  5. If you are on 5.8 or an earlier version of Neo4j, you must manually upgrade the system database. Connect to the system database on any of the servers and run the following procedure:

CALL dbms.upgrade();

From version 5.9, the system database is automatically upgraded when safe.

  1. Drop the existing neo4j database that was created by default on startup. Note, this does not remove any store files loaded via neo4j-admin database load.

    DROP DATABASE neo4j;

  2. Create the neo4j database using the store files loaded via neo4j-admin database load:

    CREATE DATABASE neo4j;